curl --request POST \
  --url https://api.evolink.ai/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "wan3.0-reference-video",
  "prompt": "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_urls": [
    "https://example.com/role.jpg",
    "https://example.com/object.png",
    "https://example.com/guitar.png",
    "https://example.com/chair.png"
  ],
  "video_urls": [
    "https://example.com/ref_role.mp4"
  ],
  "duration": 10,
  "quality": "720p",
  "aspect_ratio": "adaptive"
}
'

{
  "created": 1761313744,
  "id": "task-unified-1774857405-abc123",
  "model": "wan3.0-reference-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-reference-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 Reference-to-Video

Con imágenes / videos / audio de referencia, archivos o páginas web como material, el modelo entiende automáticamente la intención y genera el video
En el prompt, use “Image 1”, “Video 1” y “Audio 1” para referirse al material correspondiente; los tres tipos de material se cuentan de forma independiente
prompt y los materiales de referencia: debe proporcionarse al menos uno de los dos
No se aceptan fotogramas inicial y final (image_start / image_end): los materiales de referencia y los fotogramas inicial y final son excluyentes. Si necesita controlar estrictamente el inicio y el final de la imagen, use Wan3.0 imagen a video
🔴 Los videos de referencia cuentan para la facturación, las imágenes de referencia / audio de referencia / archivos / páginas web no se facturan
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-reference-video",
  "prompt": "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_urls": [
    "https://example.com/role.jpg",
    "https://example.com/object.png",
    "https://example.com/guitar.png",
    "https://example.com/chair.png"
  ],
  "video_urls": [
    "https://example.com/ref_role.mp4"
  ],
  "duration": 10,
  "quality": "720p",
  "aspect_ratio": "adaptive"
}
'

{
  "created": 1761313744,
  "id": "task-unified-1774857405-abc123",
  "model": "wan3.0-reference-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-reference-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>

predeterminado:wan3.0-reference-video

requerido

Nombre del modelo, fijo en wan3.0-reference-video

Opciones disponibles:

wan3.0-reference-video

Ejemplo:

"wan3.0-reference-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)

Reglas para referirse a los materiales:

Use "Image 1", "Image 2" para las imágenes en la posición correspondiente de image_urls (empezando en 1)
Use "Video 1", "Video 2" para los videos en la posición correspondiente de video_urls
Use "Audio 1", "Audio 2" para el audio en la posición correspondiente de audio_urls
Imágenes, videos y audio se cuentan de forma independiente, por lo que "Image 1" y "Video 1" pueden coexistir
En prompts en inglés escriba "Image 1", "Video 1", "Audio 1" (inicial en mayúscula y espacio entre la palabra y el número)

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_urls

string<uri>[]

Array de URL de imágenes de referencia, hasta 10 imágenes. 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.

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. 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. 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"]

model_params

object

Parámetros de extensión del modelo. file_url y link_url son excluyentes, solo puede usar uno de los dos

Show child attributes

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

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-reference-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 Reference-to-Video

Facturación

Autorizaciones

Cuerpo

Respuesta