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 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
prompty 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
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-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
##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)
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)
"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.”"
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
10[
"https://example.com/ref1.jpg",
"https://example.com/ref2.png"
]
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 ~ 15segundos 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
5["https://example.com/ref_video.mp4"]
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 ~ 15segundos 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
5["https://example.com/ref_audio.mp3"]
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.
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,
durationpuede ser como mucho 20
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