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 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
durationes-1(duración inteligente) se preautoriza el máximo de30segundos; 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
generate_audiocuesta lo mismo - Las tareas fallidas no se facturan, los créditos congelados se reembolsan íntegramente
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
##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
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.
"A kitten runs across a rooftop in the moonlight, city neon flickers in the distance, cinematic quality, smooth camera work."
Duración del video generado (segundos), 5 de forma predeterminada
Valores admitidos:
- Cualquier entero entre
2y30 -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.
5
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 de480p1080p: alta definición, precio 4x el de480p
480p, 720p, 1080p "720p"
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 predeterminado16:9(horizontal),9:16(vertical),1:1(cuadrado),4:3,3:4
adaptive, 16:9, 9:16, 1:1, 4:3, 3:4 "16:9"
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 predeterminadofalse: video de salida sin sonido
Con o sin sonido el precio es el mismo, no hay cargo adicional.
true
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
2048caracteres
Mecanismo de callback:
- Tiempo de espera:
10segundos - Máximo de
3reintentos después de un fallo (los reintentos ocurren después de1/2/4segundos 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
"https://your-domain.com/webhooks/video-task-completed"
Respuesta
Tarea de generación de video creada exitosamente