curl --request POST \
  --url https://api.evolink.ai/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "wan3.0-text-to-video",
  "prompt": "A kitten runs across a rooftop in the moonlight, city neon flickers in the distance, cinematic quality, smooth camera work.",
  "duration": 5,
  "quality": "720p",
  "aspect_ratio": "16:9",
  "generate_audio": true
}
'

{
  "created": 1761313744,
  "id": "task-unified-1774857405-abc123",
  "model": "wan3.0-text-to-video",
  "object": "video.generation.task",
  "progress": 0,
  "status": "pending",
  "task_info": {
    "can_cancel": true,
    "estimated_time": 165,
    "video_duration": 8
  },
  "type": "video",
  "usage": {
    "billing_rule": "per_second",
    "credits_reserved": 50,
    "user_group": "default"
  }
}

{
  "error": {
    "code": "invalid_parameter",
    "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: wan3.0-text-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"
  }
}

Wan3.0

Wan3.0 Guía completa de parámetros

API unificada de Wan 3.0 (video de referencia todo en uno), el modo se elige con el parámetro model

3 modos de generación:

Text-to-Video (wan3.0-text-to-video): genera el video solo a partir del prompt de texto
Image-to-Video (wan3.0-image-to-video): el primer fotograma / los fotogramas inicial y final controlan estrictamente el inicio y el final de la imagen
Reference-to-Video (wan3.0-reference-video): referencias multimodales mixtas — imágenes de referencia + videos de referencia + audio de referencia + archivos / páginas web

Capacidades comunes:

Videos de hasta 30 segundos
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

Facturación

Fórmula de facturación: duración facturada = duración del video de entrada + duración del video de salida, facturación por segundo
Multiplicador de resolución: 480p = 1x (base), 720p = 2x, 1080p = 4x
Las imágenes de referencia, el audio de referencia, los archivos de referencia y los enlaces de páginas web no se facturan
Cuando duration es -1 (duración inteligente) se preautoriza el máximo de 30 segundos; tras completarse la tarea se liquida según la duración realmente producida y la diferencia se reembolsa automáticamente
Activar o desactivar la pista audio cuesta lo mismo
Las tareas fallidas no se facturan, los créditos congelados se reembolsan íntegramente

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": "wan3.0-text-to-video",
  "prompt": "A kitten runs across a rooftop in the moonlight, city neon flickers in the distance, cinematic quality, smooth camera work.",
  "duration": 5,
  "quality": "720p",
  "aspect_ratio": "16:9",
  "generate_audio": true
}
'

{
  "created": 1761313744,
  "id": "task-unified-1774857405-abc123",
  "model": "wan3.0-text-to-video",
  "object": "video.generation.task",
  "progress": 0,
  "status": "pending",
  "task_info": {
    "can_cancel": true,
    "estimated_time": 165,
    "video_duration": 8
  },
  "type": "video",
  "usage": {
    "billing_rule": "per_second",
    "credits_reserved": 50,
    "user_group": "default"
  }
}

{
  "error": {
    "code": "invalid_parameter",
    "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: wan3.0-text-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 Bearer Token##

Obtener API Key:

Visita la Página de gestión de API Key para obtener tu API Key

Agregar al encabezado de la solicitud:

Authorization: Bearer YOUR_API_KEY

Cuerpo

application/json

model

enum<string>

requerido

Nombre del modelo de generación de video

Opciones disponibles:

wan3.0-text-to-video,

wan3.0-image-to-video,

wan3.0-reference-video

Ejemplo:

"wan3.0-text-to-video"

prompt

string

Prompt de texto para la generación de video. Admite chino e inglés, cada carácter chino / letra cuenta como 1 carácter, longitud máxima 20000 caracteres; el excedente se trunca automáticamente (sin error)

Obligatoriedad: obligatorio para wan3.0-text-to-video; para wan3.0-reference-video debe haber al menos prompt o materiales de referencia; para wan3.0-image-to-video se recomienda enviarlo para describir el cambio de imagen

Reglas para referirse a los materiales (referencia a video):

Use "Image 1", "Video 1" y "Audio 1" para referirse a los materiales del array correspondiente (empezando en 1)
Imágenes, videos y audio se cuentan de forma independiente, por lo que "Image 1" y "Video 1" pueden coexistir

Ejemplo:

"The character in Video 1 holds Image 3 and plays a soft country folk tune on the chair in Image 4, saying: “What lovely sunshine today.”"

image_start

string<uri>

URL de la imagen del primer fotograma, usada estrictamente como primer fotograma del video generado. Solo disponible para wan3.0-image-to-video

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, usada estrictamente como último fotograma del video generado. Solo disponible para wan3.0-image-to-video

Restricción: debe usarse junto con image_start, no se admite enviar solo el ú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"

image_urls

string<uri>[]

Array de URL de imágenes de referencia, hasta 10 imágenes, solo disponible para wan3.0-reference-video. Puede aportar sujetos (personas/animales/objetos) o fondos de escena; cuando incluya un sujeto, se recomienda que cada imagen contenga un único personaje

El orden del array se corresponde con "Image 1, Image 2..." del prompt

Nota: para los fotogramas inicial y final de imagen a video use image_start / image_end, no este campo

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

Maximum array length: 10

Ejemplo:

[
  "https://example.com/ref1.jpg",
  "https://example.com/ref2.png"
]

video_urls

string<uri>[]

Array de URL de videos de referencia, hasta 5 clips, solo disponible para wan3.0-reference-video. El orden del array se corresponde con "Video 1, Video 2..." del prompt

Límites de duración:

1 ~ 15 segundos por clip
15 segundos como máximo en total
La duración total de los videos de referencia + la duración del video de salida no puede superar 30 segundos

🔴 Los videos de referencia cuentan para la facturación: duración facturada = duración del video de entrada + duración del video de salida. Las imágenes de referencia, el audio de referencia, los archivos y las páginas web no se facturan

Límites de video:

Formatos: mp4, mov
Resolución: ancho y alto en [240, 4096] píxeles
Relación de aspecto: 1:8 ~ 8:1
Tamaño por archivo: hasta 100MB

Maximum array length: 5

Ejemplo:

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

audio_urls

string<uri>[]

Array de URL de audio de referencia, hasta 5 clips, solo disponible para wan3.0-reference-video. El orden del array se corresponde con "Audio 1, Audio 2..." del prompt

⚠️ Semántica distinta a la de Wan2.7: en Wan2.7, audio_urls era una voz vinculada a una imagen o un video de referencia concretos; en Wan3.0 el audio de referencia es un material independiente al que el prompt hace referencia directamente como "Audio 1", y el protocolo de vinculación de voz model_params.voice_bindings no se admite. Tenga en cuenta la reescritura al migrar desde Wan2.7.

Límites de duración:

1 ~ 15 segundos por clip, 15 segundos como máximo en total
El audio de referencia no se factura

Límites de audio:

Formatos: wav, mp3
Tamaño de archivo: hasta 15MB

Maximum array length: 5

Ejemplo:

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

duration

integer

predeterminado:5

Duración del video generado (segundos), 5 de forma predeterminada

Valores admitidos:

Cualquier entero entre 2 y 30
-1: duración inteligente, el modelo decide la longitud de salida a partir del prompt y los materiales de entrada

Cómo se factura la duración inteligente: al enviar la solicitud no se sabe cuánto durará el resultado, por lo que se preautoriza el máximo de 30 segundos; tras completarse la tarea se liquida según la duración realmente producida y el exceso congelado se libera automáticamente. Si su saldo no cubre la preautorización máxima, indique un número de segundos explícito.

Restricción adicional al enviar videos de referencia:

La duración total de los videos de referencia + la duración del video de salida no puede superar 30 segundos
Ejemplo: con 10 segundos de video de referencia en total, duration puede ser como mucho 20

Ejemplo:

5

quality

enum<string>

predeterminado:720p

Resolución del video, 720p de forma predeterminada

Valores posibles:

480p: menor definición, precio más bajo (base de facturación)
720p: definición estándar, valor predeterminado, precio 2x el de 480p
1080p: alta definición, precio 4x el de 480p

Opciones disponibles:

480p,

720p,

1080p

Ejemplo:

"720p"

aspect_ratio

enum<string>

predeterminado:adaptive

Relación de aspecto del video, adaptive de forma predeterminada

Valores posibles:

adaptive: adaptativa, el modelo recomienda una relación de aspecto adecuada según la proporción de los materiales de entrada y la intención del prompt, valor predeterminado
16:9 (horizontal), 9:16 (vertical), 1:1 (cuadrado), 4:3, 3:4

Opciones disponibles:

adaptive,

16:9,

9:16,

1:1,

4:3,

3:4

Ejemplo:

"16:9"

generate_audio

boolean

predeterminado:true

Indica si el video de salida incluye pista de audio, true de forma predeterminada

Valores posibles:

true: el video de salida incluye sonido (voces, efectos, música de fondo), valor predeterminado
false: video de salida sin sonido

Con o sin sonido el precio es el mismo, no hay cargo adicional.

Ejemplo:

true

seed

integer

Semilla aleatoria, sirve para reproducir los resultados, aleatoria de forma predeterminada

Notas:

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

Rango requerido: 0 <= x <= 2147483647

Ejemplo:

42

model_params

object

Parámetros de extensión del modelo, solo disponibles para wan3.0-reference-video. file_url y link_url son excluyentes, solo puede usar uno de los dos

Show child attributes

callback_url

string<uri>

URL de callback HTTPS después de completar la tarea

Momento del callback:

Se activa cuando la tarea se completa (completed), falla (failed) o se cancela (cancelled)
Se envía después de completar la confirmación de facturación

Restricciones de seguridad:

Solo se admite el protocolo HTTPS
Se prohíben los callbacks a direcciones IP de red interna (127.0.0.1, 10.x.x.x, 172.16-31.x.x, 192.168.x.x, etc.)
La longitud de la URL no debe exceder 2048 caracteres

Mecanismo de callback:

Tiempo de espera: 10 segundos
Máximo de 3 reintentos después de un fallo (los reintentos ocurren después de 1/2/4 segundos tras el fallo)
El formato del cuerpo de respuesta del callback es consistente con el formato de respuesta de la API de consulta de tareas
Un código de estado 2xx se considera exitoso, otros códigos de estado activan reintentos

Ejemplo:

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

Respuesta

Tarea de generación de video creada exitosamente

created

integer

Marca de tiempo de creación de la tarea

Ejemplo:

1761313744

string

ID de tarea

Ejemplo:

"task-unified-1774857405-abc123"

model

string

Nombre del modelo realmente utilizado

Ejemplo:

"wan3.0-text-to-video"

object

enum<string>

Tipo específico de la tarea

Opciones disponibles:

video.generation.task

progress

integer

Porcentaje de progreso de la tarea (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

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

Wan3.0 Guía completa de parámetros

Facturación

Autorizaciones

Cuerpo

Respuesta