Guía de la API Wan 2.7: Texto a Vídeo, Imagen a Vídeo, Vídeo de Referencia y Edición de Vídeo — Manual Completo de Integración

Resumen

• Wan 2.7 son cuatro modelos en un solo endpoint. Texto a vídeo, imagen a vídeo (con control de primer/último fotograma), vídeo de referencia multicarácter (con clonación de voz), y edición de vídeo basada en instrucciones — todo a través de POST /v1/videos/generations.
• Precios en EvoLink: $0.086/seg a 720p, $0.144/seg a 1080p. Un clip de 10 segundos a 720p cuesta $0.86. Sin suscripciones.
• IDs de modelo: wan2.7-text-to-video, wan2.7-image-to-video, wan2.7-reference-video, wan2.7-video-edit.
• Flujo asíncrono. Cada solicitud devuelve un ID de tarea inmediatamente. Consulta GET /v1/tasks/\{task_id\} para el estado. Las URLs de vídeo expiran en 24 horas.
• Lo que Wan 2.7 añade sobre Wan 2.6 en EvoLink: Edición de vídeo a través de la ruta Wan 2.7, control de primer y último fotograma en I2V, y vídeo de referencia multicarácter con clonación de voz.
• Las tareas fallidas no se facturan para los modos de vídeo de referencia y edición de vídeo.

Tabla de contenidos

1. Inicio rápido: tu primer vídeo Wan 2.7 en 60 segundos
2. Elige el ID de modelo correcto
3. Modo 1: Texto a vídeo
4. Modo 2: Imagen a vídeo con control de fotogramas
5. Modo 3: Vídeo de referencia con clonación de voz
6. Modo 4: Edición de vídeo
7. Precios y cálculo de costes
8. Flujo asíncrono y gestión de tareas
9. Manejo de errores y códigos de estado comunes
10. Patrones de producción y salvaguardas
11. Migración de Wan 2.6 a Wan 2.7
12. Hoja de referencia de parámetros
13. Preguntas frecuentes

1. Inicio rápido: tu primer vídeo Wan 2.7 en 60 segundos

Paso 1: Genera un vídeo

curl -X POST https://api.evolink.ai/v1/videos/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "wan2.7-text-to-video",
    "prompt": "A drone shot over a misty mountain lake at sunrise, slow camera push forward, cinematic color grading",
    "quality": "720p",
    "aspect_ratio": "16:9",
    "duration": 5
  }'

{
  "id": "task-unified-1757169743-7cvnl5zw",
  "status": "pending",
  "created": 1757169743
}

Paso 2: Consulta el resultado

curl https://api.evolink.ai/v1/tasks/task-unified-1757169743-7cvnl5zw \
  -H "Authorization: Bearer YOUR_API_KEY"

Paso 3: Eso es todo

2. Elige el ID de modelo correcto

3. Modo 1: Texto a vídeo

Qué hace

Genera un vídeo a partir de un prompt de texto. Admite audio de conducción opcional para sincronización labial o salida sincronizada con música. Genera música de fondo automáticamente cuando no se proporciona audio.

Parámetros clave

Narrativa multi-toma

Controla la estructura de tomas directamente en el prompt:

{
  "model": "wan2.7-text-to-video",
  "prompt": "A tense detective story. Shot 1 [0-3s] wide angle: rainy night street, neon lights. Shot 2 [3-6s] medium: detective enters old building. Shot 3 [6-9s] close-up: detective's determined eyes. Shot 4 [9-12s] medium: cautious advance through dim corridor. Shot 5 [12-15s] close-up: discovers key clue.",
  "aspect_ratio": "16:9",
  "duration": 15
}

Con audio de conducción

{
  "model": "wan2.7-text-to-video",
  "prompt": "A cartoon general in golden armor on a horse, reciting a classical poem",
  "audio_urls": ["https://your-cdn.com/recital.mp3"],
  "duration": 10
}

4. Modo 2: Imagen a vídeo con control de fotogramas

Qué hace

Tres modos de generación

Combinaciones de entrada válidas

1. Solo image_start
2. image_start + audio_urls
3. image_start + image_end
4. image_start + image_end + audio_urls
5. video_urls (continuación)
6. video_urls + image_end (continuación con fotograma final)

Cualquier otra combinación será rechazada.

Ejemplo: Primer y último fotograma

curl -X POST https://api.evolink.ai/v1/videos/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "wan2.7-image-to-video",
    "generation_mode": "first_last_frame",
    "prompt": "A product bottle rotating 360 degrees with soft studio lighting",
    "image_start": "https://your-cdn.com/bottle-front.jpg",
    "image_end": "https://your-cdn.com/bottle-back.jpg",
    "quality": "1080p",
    "duration": 5
  }'

Ejemplo: Continuación de vídeo

{
  "model": "wan2.7-image-to-video",
  "generation_mode": "video_continuation",
  "prompt": "The scene continues with the character walking toward the sunset",
  "video_urls": ["https://your-cdn.com/previous-clip.mp4"],
  "image_end": "https://your-cdn.com/sunset-ending.jpg",
  "duration": 5
}

5. Modo 3: Vídeo de referencia con clonación de voz

Qué hace

Genera nuevas escenas de vídeo preservando la apariencia de personajes a partir de imágenes o vídeos de referencia — y opcionalmente clonando su voz a partir de una muestra corta de audio. Así es como se construyen series de vídeo multicarácter donde cada persona se ve y suena consistente entre episodios.

Restricciones clave

• image_urls + video_urls combinados: máximo 5 elementos en total
• image_start y el audio de voz no cuentan para este límite de 5 elementos
• Duración: 2-15 seg (solo referencias de imagen), 2-10 seg (cuando se incluyen vídeos de referencia)
• Facturación: duración del vídeo de entrada + duración del vídeo de salida. Las tareas fallidas son gratuitas.

Indexación de personajes en prompts

Referencia a los personajes por su posición en los arrays de entrada:

• Inglés: Image 1, Image 2, Video 1, Video 2
• Chino: 图1, 图2, 视频1, 视频2

Clonación de voz: dos métodos

Mapeo preciso clave-valor entre referencias de personajes y audio de voz:

{
  "model": "wan2.7-reference-video",
  "prompt": "Image 1 holds Image 2 and says: 'What lovely sunshine today'",
  "image_urls": [
    "https://your-cdn.com/girl.jpg",
    "https://your-cdn.com/toy.png"
  ],
  "model_params": {
    "voice_bindings": {
      "image1": "https://your-cdn.com/girl-voice.mp3"
    }
  },
  "duration": 10
}

Ejemplo: Vídeo de marca multicarácter

{
  "model": "wan2.7-reference-video",
  "prompt": "Image 1 and Image 2 are having a conversation in a modern office. Image 1 explains the product while Image 2 takes notes. The scene is professional and well-lit.",
  "image_urls": [
    "https://your-cdn.com/spokesperson-a.jpg",
    "https://your-cdn.com/spokesperson-b.jpg"
  ],
  "image_start": "https://your-cdn.com/office-wide-shot.jpg",
  "model_params": {
    "voice_bindings": {
      "image1": "https://your-cdn.com/voice-a.mp3",
      "image2": "https://your-cdn.com/voice-b.mp3"
    }
  },
  "quality": "1080p",
  "duration": 10
}

Storyboard multi-panel

Para referencias de imagen única con múltiples paneles (por ejemplo, una cuadrícula 3×3 de poses de personaje):

{
  "model": "wan2.7-reference-video",
  "prompt": "Reference image. 3D cartoon style. 1. Wide shot of fantasy forest. 2. Boy parts the vines. 3. Robot scans ahead. 4. Close-up of map. 5. Boy's excited face. 6. They leap over roots.",
  "image_urls": ["https://your-cdn.com/storyboard-grid.png"],
  "duration": 15
}

6. Modo 4: Edición de vídeo

Qué hace

Parámetros clave

Ejemplo: Cambio de estilo solo con instrucción

curl -X POST https://api.evolink.ai/v1/videos/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "wan2.7-video-edit",
    "prompt": "Convert the entire scene to a vintage film look with warm color grading and film grain",
    "video_urls": ["https://your-cdn.com/source-clip.mp4"],
    "keep_original_sound": true,
    "duration": 0
  }'

Ejemplo: Reemplazo de ropa guiado por referencia

{
  "model": "wan2.7-video-edit",
  "prompt": "Replace the girl's outfit with the clothes from the reference image",
  "video_urls": ["https://your-cdn.com/source.mp4"],
  "image_urls": ["https://your-cdn.com/target-outfit.png"]
}

Qué puedes editar

• Transferencia de estilo: "convertir a estilo anime", "aplicar efecto de pintura en acuarela"
• Cambio de fondo: "cambiar el fondo a una calle de Tokio bajo la lluvia de noche"
• Cambio de objeto/ropa: "cambiar la chaqueta a roja", "reemplazar el sombrero con una corona"
• Colorización: "convertir este metraje en blanco y negro a color"
• Iluminación: "cambiar la iluminación a hora dorada"

7. Precios y cálculo de costes

Precios de EvoLink para Wan 2.7

Sin suscripciones, sin compromisos mínimos. Solo pagas por vídeo generado exitosamente.

Comparación de costes con otros proveedores (según aparece en las páginas de proveedores, mayo 2026)

Facturación especial para vídeo de referencia y edición de vídeo

Fórmula de estimación de presupuesto

8. Flujo asíncrono y gestión de tareas

Cada solicitud de Wan 2.7 sigue el mismo patrón asíncrono:

Ciclo de vida de la tarea

URL de callback (webhook)

Mejores prácticas de producción

1. Persiste el ID de tarea inmediatamente después del envío. Si tu servicio falla, podrás recuperarte.
2. Usa retroceso exponencial al consultar. Comienza en 5 segundos, máximo en 30 segundos.
3. Descarga y archiva los resultados inmediatamente. Las URLs de vídeo expiran en 24 horas.
4. Haz los envíos idempotentes. Hashea las cargas útiles de solicitud y deduplica para evitar doble facturación por tormentas de reintentos.

9. Manejo de errores y códigos de estado comunes

Errores comunes

• Usar el ID de modelo con ortografía incorrecta. Es wan2.7-text-to-video, no wan-2.7-text-to-video ni wan27-t2v. Un ID de modelo obsoleto devuelve un 404 limpio sin error útil.
• Enviar combinaciones de medios inválidas en modo I2V. Consulta la tabla de combinaciones de entrada válidas.
• No descargar resultados a tiempo. Las URLs de vídeo expiran en 24 horas. Integra descarga automática en tu pipeline.

10. Patrones de producción y salvaguardas

Salvaguardas de presupuesto

Patrones de fiabilidad

• Reintentar con clave de idempotencia. Hashea tu carga útil de solicitud y verifica tareas existentes antes de reenviar.
• Manejo de timeout. Si una tarea no se ha completado después de 5 minutos, márcala para revisión manual en lugar de reenviarla a ciegas.
• Estrategia de fallback. Considera recurrir a Wan 2.6 o Wan 2.5 si Wan 2.7 devuelve errores persistentes en un modo específico.
• Validación de activos. Valida dimensiones de imagen, duración de vídeo y formato de audio antes del envío. Los activos defectuosos causan fallos que parecen problemas de calidad del modelo.

Arquitectura de cola

Para sistemas de producción que generan más de 100 vídeos/día:

Nunca llames a la API directamente desde los manejadores de solicitudes orientados al usuario. Siempre pasa por un sistema de trabajos en segundo plano.

11. Migración de Wan 2.6 a Wan 2.7

Qué permanece igual

• Endpoint de API: POST /v1/videos/generations
• Autenticación: misma API key y Bearer token
• Patrón asíncrono: mismo flujo de ID de tarea / consulta / callback
• Facturación de EvoLink: misma cuenta y sistema de créditos

Qué cambia

Migración paso a paso

1. Cambia el parámetro model. Reemplaza wan2.6-text-to-video con wan2.7-text-to-video (igual para los otros modos).
2. Prueba con los prompts existentes. Wan 2.7 maneja el mismo formato de prompt. No se necesita reescritura.
3. Adopta las nuevas funciones gradualmente. Añade generation_mode, image_end, voice_bindings o edición de vídeo según lo requiera tu flujo de trabajo.
4. Mantén Wan 2.6 como fallback. Ambas versiones funcionan en paralelo en EvoLink. No tienes que migrar todo a la vez.

12. Hoja de referencia de parámetros

Parámetros compartidos (todos los modos)

Específicos de texto a vídeo

Específicos de imagen a vídeo

Específicos de vídeo de referencia

Específicos de edición de vídeo

13. Preguntas frecuentes

¿Cuánto cuesta Wan 2.7 en EvoLink?

$0.086/seg a 720p, $0.144/seg a 1080p. Un clip de 10 segundos a 720p cuesta $0.86. Sin suscripciones ni compromisos mínimos.

¿Cuál es la diferencia entre Wan 2.7 y Wan 2.6?

En EvoLink, Wan 2.7 ofrece edición de vídeo, vídeo de referencia multicarácter con clonación de voz, y control de primer y último fotograma en el modo I2V. Wan 2.6 sigue siendo útil para narrativa cinematográfica y variantes Flash para iteración más rápida. Ambos funcionan en paralelo en EvoLink.

¿Wan 2.7 genera audio automáticamente?

¿Se facturan las tareas fallidas?

Para los modos de vídeo de referencia y edición de vídeo, las tareas fallidas explícitamente no se facturan. Para texto a vídeo e imagen a vídeo, la facturación se basa en la duración real del vídeo generado.

¿Puedo usar Wan 2.7 para contenido NSFW?

¿Qué formatos de audio se admiten para la clonación de voz?

¿Cómo manejo la expiración de URLs de vídeo?

Las URLs de vídeo expiran después de 24 horas. Integra un paso automático de descarga y archivo en tu pipeline inmediatamente después de la finalización de la tarea. Almacena el activo final en tu propio CDN o almacenamiento de objetos.

¿Puedo migrar de Wan 2.6 sin tiempo de inactividad?

Próximos pasos

• Prueba el playground: Página del modelo Wan 2.7
• Compara modelos Wan: Colección de la familia Wan API
• Desglose completo de precios: Guía de precios de Wan API
• Patrones de producción Wan 2.6: Guía de la API Wan 2.6
• Reseña de Wan 2.5: Reseña de la API Wan 2.5