curl --request POST \
  --url https://api.evolink.ai/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "wan2.7-image-to-video",
  "generation_mode": "first_frame",
  "prompt": "Un gato tocando el piano",
  "image_start": "https://example.com/first_frame.jpg"
}
'

{
  "created": 1757169743,
  "id": "task-unified-1757169743-7cvnl5zw",
  "model": "wan2.7-image-to-video",
  "object": "video.generation.task",
  "progress": 0,
  "status": "pending",
  "task_info": {
    "can_cancel": true,
    "estimated_time": 120
  },
  "type": "video",
  "usage": {
    "billing_rule": "per_call",
    "credits_reserved": 5,
    "user_group": "default"
  }
}

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid request parameters",
    "type": "invalid_request_error"
  }
}

{
  "error": {
    "code": "unauthorized",
    "message": "Invalid or expired token",
    "type": "authentication_error"
  }
}

{
  "error": {
    "code": "insufficient_quota",
    "message": "Insufficient quota. Please top up your account.",
    "type": "insufficient_quota"
  }
}

{
  "error": {
    "code": "model_access_denied",
    "message": "Token does not have access to model: wan2.7-image-to-video",
    "type": "invalid_request_error"
  }
}

{
  "error": {
    "code": "rate_limit_exceeded",
    "message": "Too many requests, please try again later",
    "type": "rate_limit_error"
  }
}

{
  "error": {
    "code": "internal_error",
    "message": "Internal server error",
    "type": "api_error"
  }
}

Wan2.7

Wan2.7 Imagen a video

El modelo WAN2.7 (wan2.7-image-to-video) admite generación de imagen a video con entradas multimodales (imagen / audio / video)
Elija uno de tres modos de generación mediante generation_mode:
- first_frame: Primer fotograma a video — genera un video a partir del fotograma inicial, con audio impulsor opcional
- first_last_frame: Primer y último fotograma a video — genera un video interpolando entre el primer y último fotograma, con audio impulsor opcional
- video_continuation: Continuación de video — continúa un clip de video de entrada; se permite un fotograma final opcional (sin audio impulsor)
generation_mode es opcional (compatibilidad hacia atrás); si se omite, se selecciona automáticamente el modo apropiado según los materiales proporcionados
Combinaciones de materiales válidas (cualquier otra será rechazada):
1. image_start (primer fotograma)
2. image_start + audio_urls (primer fotograma + audio impulsor)
3. image_start + image_end (primer + último fotograma)
4. image_start + image_end + audio_urls (primer + último fotograma + audio impulsor)
5. video_urls (continuación de video)
6. video_urls + image_end (continuación de video + último fotograma)
Modo de procesamiento asíncrono, use el ID de tarea devuelto para consultar el estado
Los enlaces de video generados son válidos durante 24 horas, guárdelos cuanto antes

POST

videos

generations

curl --request POST \
  --url https://api.evolink.ai/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "wan2.7-image-to-video",
  "generation_mode": "first_frame",
  "prompt": "Un gato tocando el piano",
  "image_start": "https://example.com/first_frame.jpg"
}
'

{
  "created": 1757169743,
  "id": "task-unified-1757169743-7cvnl5zw",
  "model": "wan2.7-image-to-video",
  "object": "video.generation.task",
  "progress": 0,
  "status": "pending",
  "task_info": {
    "can_cancel": true,
    "estimated_time": 120
  },
  "type": "video",
  "usage": {
    "billing_rule": "per_call",
    "credits_reserved": 5,
    "user_group": "default"
  }
}

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid request parameters",
    "type": "invalid_request_error"
  }
}

{
  "error": {
    "code": "unauthorized",
    "message": "Invalid or expired token",
    "type": "authentication_error"
  }
}

{
  "error": {
    "code": "insufficient_quota",
    "message": "Insufficient quota. Please top up your account.",
    "type": "insufficient_quota"
  }
}

{
  "error": {
    "code": "model_access_denied",
    "message": "Token does not have access to model: wan2.7-image-to-video",
    "type": "invalid_request_error"
  }
}

{
  "error": {
    "code": "rate_limit_exceeded",
    "message": "Too many requests, please try again later",
    "type": "rate_limit_error"
  }
}

{
  "error": {
    "code": "internal_error",
    "message": "Internal server error",
    "type": "api_error"
  }
}

Autorizaciones

Authorization

string

header

requerido

Todas las APIs requieren autenticación con Bearer Token

Obtenga su API Key:

Visite la página de gestión de API Keys para obtener su API Key

Añada al encabezado de la solicitud:

Authorization: Bearer YOUR_API_KEY

Cuerpo

application/json

model

enum<string>

requerido

Nombre del modelo, debe ser wan2.7-image-to-video

Opciones disponibles:

wan2.7-image-to-video

Ejemplo:

"wan2.7-image-to-video"

generation_mode

enum<string>

Modo de generación que determina qué combinaciones de materiales son válidas. Se recomienda especificarlo explícitamente

Valores:

first_frame: Primer fotograma a video. Requerido: image_start. Opcional: audio_urls. No aceptado: image_end, video_urls
first_last_frame: Primer y último fotograma a video. Requerido: image_start + image_end. Opcional: audio_urls. No aceptado: video_urls
video_continuation: Continuación de video. Requerido: video_urls[0]. Opcional: image_end (como fotograma final). No aceptado: image_start, audio_urls

Comportamiento de compatibilidad: cuando se omite generation_mode, se selecciona automáticamente el modo apropiado según los materiales proporcionados; especificarlo explícitamente evita ambigüedades

Opciones disponibles:

first_frame,

first_last_frame,

video_continuation

Ejemplo:

"first_frame"

prompt

string

Prompt textual para la generación de video. Admite chino e inglés; cada carácter/letra cuenta como 1, el exceso se trunca automáticamente. Longitud máxima: 5000 caracteres

Maximum string length: 5000

Ejemplo:

"Un gato tocando el piano"

negative_prompt

string

Prompt negativo que describe lo que no debe aparecer en el video. Admite chino e inglés. Longitud máxima 500 caracteres; el exceso se trunca automáticamente

Maximum string length: 500

Ejemplo:

"Borroso, baja calidad"

image_start

string<uri>

URL de la imagen del primer fotograma

Restricciones por modo:

Modo first_frame: requerido
Modo first_last_frame: requerido
Modo video_continuation: no permitido

Límites de imagen:

Formatos: JPEG, JPG, PNG (sin transparencia), BMP, WEBP
Resolución: ancho y alto en [240, 8000] píxeles
Relación de aspecto: 1:8 ~ 8:1
Tamaño de archivo: hasta 20MB

Ejemplo:

"https://example.com/first_frame.jpg"

image_end

string<uri>

URL de la imagen del último fotograma

Restricciones por modo:

Modo first_last_frame: requerido
Modo video_continuation: opcional (actúa como fotograma final de la continuación)
Modo first_frame: no permitido (use first_last_frame si necesita primer y último fotograma)

Límites de imagen:

Formatos: JPEG, JPG, PNG (sin transparencia), BMP, WEBP
Resolución: ancho y alto en [240, 8000] píxeles
Relación de aspecto: 1:8 ~ 8:1
Tamaño de archivo: hasta 20MB

Ejemplo:

"https://example.com/last_frame.jpg"

video_urls

string<uri>[]

Lista de URLs para continuación de video. Solo se admite 1 elemento

Restricciones por modo:

Modo video_continuation: requerido
Modo first_frame / first_last_frame: no permitido
No puede combinarse con audio_urls

Límites de video:

Formatos: mp4, mov
Duración: 2 ~ 10 segundos (longitud del clip de entrada)
Resolución: ancho y alto en [240, 4096] píxeles
Relación de aspecto: 1:8 ~ 8:1
Tamaño de archivo: hasta 100MB

Reglas de duración para continuación:

duration representa la duración total del video final de salida (clip de entrada + continuación generada por el modelo)
Duración generada por el modelo = duration − duración del video de entrada
duration debe ser ≥ duración del video de entrada
La facturación se basa en la duración total del video final (es decir, duration)

Ejemplos:

Duración del clip de entrada	duration	Continuación generada	Salida final	Facturado
3s	15	12s	15s	15s
5s	10	5s	10s	10s
8s	8	0s (solo entrada)	8s	8s

Ejemplo:

["https://example.com/clip.mp4"]

audio_urls

string<uri>[]

Lista de URLs de audio impulsor. Actualmente solo se admite 1 elemento. El modelo usará este audio como fuente impulsora para la generación (p. ej. sincronización labial, sincronización de movimiento)

Restricciones por modo:

Modo first_frame: opcional
Modo first_last_frame: opcional
Modo video_continuation: no permitido (no puede combinarse con video_urls)

Requisitos de formato:

Formatos admitidos: wav, mp3
Duración: 2 ~ 30 segundos
Tamaño de archivo: hasta 15MB

Manejo de truncamiento:

Si la duración del audio supera duration, se usan los primeros N segundos y el resto se descarta
Si la duración del audio es menor que la del video, la parte restante queda en silencio. Por ejemplo: con audio de 3s y video de 5s, los primeros 3s tienen sonido y los últimos 2s son silenciosos

Required array length: 1 element

Ejemplo:

["https://example.com/audio.mp3"]

quality

enum<string>

predeterminado:720p

Calidad del video, predeterminada 720p

Opciones:

720p: Definición estándar, precio estándar (predeterminado)
1080p: Alta definición, precio mayor

Opciones disponibles:

720p,

1080p

Ejemplo:

"720p"

duration

number

predeterminado:5

Duración del video en segundos (entero). Rango 2 ~ 15, predeterminado 5

Significado:

Modos first_frame / first_last_frame: longitud total del video generado
Modo video_continuation: longitud total del video final de salida (= clip de entrada + continuación generada por el modelo)

Restricciones adicionales en modo video_continuation:

duration debe ser ≥ duración del video de entrada (de lo contrario, se devuelve un error)
Duración generada por el modelo = duration − duración del video de entrada
Cuando duration iguala la duración del video de entrada, no se genera continuación y se devuelve el clip de entrada tal cual
Vea las reglas y ejemplos de continuación en el campo video_urls

Facturación: basada en la duración real del video generado

Rango requerido: 2 <= x <= 15

Ejemplo:

5

seed

integer

Semilla aleatoria, aleatoria por defecto

Notas:

Rango: 1 ~ 2147483647
Fijar la semilla reduce la variación al iterar prompts y mejora la reproducibilidad

Rango requerido: 1 <= x <= 2147483647

Ejemplo:

42

prompt_extend

boolean

predeterminado:false

Si activar la reescritura inteligente del prompt. Cuando se activa, un modelo grande optimiza el prompt, mejorando notablemente los resultados con prompts simples o poco descriptivos.

Nota: El valor predeterminado es false. Omitir el campo o enviar false no activará la reescritura; envíe true explícitamente para habilitarla.

Ejemplo:

false

callback_url

string<uri>

URL de callback HTTPS para la finalización de la tarea

Momento del callback:

Se dispara cuando la tarea se completa, falla o se cancela
Se envía tras la confirmación de facturación

Restricciones de seguridad:

Solo se admite HTTPS
Los callbacks a direcciones IP internas están prohibidos (127.0.0.1, 10.x.x.x, 172.16-31.x.x, 192.168.x.x, etc.)
La URL no debe superar 2048 caracteres

Mecanismo de callback:

Tiempo de espera: 10 segundos
Hasta 3 reintentos tras fallo (a 1/2/4 segundos)
El formato de respuesta del callback es idéntico al de la API de consulta de tareas
Códigos 2xx se consideran exitosos; otros códigos disparan reintentos

Ejemplo:

"https://your-domain.com/webhooks/video-task-completed"

Respuesta

Tarea de video creada con éxito

created

integer

Marca de tiempo de creación de la tarea

Ejemplo:

1757169743

string

ID de la tarea

Ejemplo:

"task-unified-1757169743-7cvnl5zw"

model

string

Nombre del modelo realmente usado

Ejemplo:

"wan2.7-image-to-video"

object

enum<string>

Tipo específico de tarea

Opciones disponibles:

video.generation.task

progress

integer

Progreso de la tarea en porcentaje (0-100)

Rango requerido: 0 <= x <= 100

Ejemplo:

0

status

enum<string>

Estado de la tarea

Opciones disponibles:

pending,

processing,

completed,

failed

Ejemplo:

"pending"

task_info

object

Información detallada de la tarea de video

Show child attributes

type

enum<string>

Tipo de salida de la tarea

Opciones disponibles:

text,

image,

audio,

video

Ejemplo:

"video"

usage

object

Información de uso y facturación

Show child attributes

Wan2.7 Texto a video Wan2.7 Video de referencia

Serie de imágenes

Serie de videos

Serie de audio

Serie de texto

Gestión de cuenta

Gestión de tareas

Gestión de archivos

Wan2.7 Imagen a video

Autorizaciones

Todas las APIs requieren autenticación con Bearer Token

Cuerpo

Respuesta