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 Text-to-Video

Genera el video solo con prompt, no acepta ninguna entrada multimedia
Videos de hasta 30 segundos, admite la duración inteligente duration: -1
Si necesita control de fotogramas inicial y final use Wan3.0 imagen a video; si necesita materiales de referencia use Wan3.0 referencia a video
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>

predeterminado:wan3.0-text-to-video

requerido

Nombre del modelo, fijo en wan3.0-text-to-video

Opciones disponibles:

wan3.0-text-to-video

Ejemplo:

"wan3.0-text-to-video"

prompt

string

requerido

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)

Nota: este modelo es de texto a video puro y no acepta ninguna entrada multimedia.

Ejemplo:

"A kitten runs across a rooftop in the moonlight, city neon flickers in the distance, cinematic quality, smooth camera work."

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.

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-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 Text-to-Video

Facturación

Autorizaciones

Cuerpo

Respuesta