Documentos para desarrolladores UlazAI
Wan 3.0 Video API
Referencia de Wan 3.0
Crea tareas de Wan 3.0 video
Envía las solicitudes a POST /api/v1/video-studio/generate/ con
wan_3_0_video o wan_3_0_video_prime como slug del modelo.
Consulta el progreso con GET /api/v1/video-studio/status/{job_id}/.
Crear
POST /api/v1/video-studio/generate/
GET /api/v1/video-studio/status/{job_id}/
Modelos
wan_3_0_video
wan_3_0_video_prime
Salida
2-30 segundos
480P, 720P o 1080P
Parámetros
| Campo | Tipo | Límites y combinaciones |
|---|---|---|
model_slug | string | wan_3_0_video o wan_3_0_video_prime. |
prompt | string | Máximo 20,000 caracteres. |
duration_seconds | integer | 2-30. Con video de referencia, la duración de entrada más la de salida deben sumar menos de 30 segundos. |
quality_mode | string | 480p, 720p o 1080p. |
aspect_ratio | string | adaptive, 16:9, 4:3, 1:1, 3:4 o 9:16. |
sound | boolean | Activado por defecto. El audio nativo se genera junto con el video. |
first_frame_url | string | JPEG, PNG, WebP o BMP. Cada lado de 240-8000 px, relación de aspecto de como máximo 8:1, máximo 20 MB. No se puede combinar con imágenes de referencia, un enlace o un archivo. |
last_frame_url | string | Los mismos límites de imagen que el primer fotograma. No se puede combinar con imágenes de referencia, un enlace ni un archivo. |
reference_image_urls | array | Máximo 10 imágenes. No se puede combinar con el primer o el último fotograma. |
reference_video_urls | array | Máximo 5 archivos MP4 o MOV, de 1-15 segundos cada uno, 15 segundos en conjunto, máximo 100 MB cada uno. La duración del vídeo de entrada más la de la salida no puede superar los 30 segundos. |
reference_audio_urls | array | Máximo 5 archivos WAV o MP3, de 1-15 segundos cada uno, 15 segundos en conjunto, máximo 15 MB cada uno. |
Tarifas de créditos por segundo
Se cobran tanto los segundos del video de referencia como los segundos de salida solicitados.
| Resolución | Wan 3.0 Video | Wan 3.0 Video Prime |
|---|---|---|
| 480p | 9.6 créditos/s | 14.64 créditos/s |
| 720p | 19.2 créditos/s | 30.24 créditos/s |
| 1080p | 38.4 créditos/s | 60.48 créditos/s |
Crear una tarea
Texto a vídeo
{
"model_slug": "wan_3_0_video",
"prompt": "A slow tracking shot through a workshop at sunrise",
"duration_seconds": 5,
"quality_mode": "720p",
"aspect_ratio": "16:9",
"sound": true
}Imágenes de referencia a video
{
"model_slug": "wan_3_0_video_prime",
"prompt": "Keep the character and product consistent while the camera moves through the studio",
"duration_seconds": 8,
"quality_mode": "1080p",
"aspect_ratio": "16:9",
"sound": true,
"reference_image_urls": [
"https://media.ulazai.com/examples/wan30-character-reference.jpg",
"https://media.ulazai.com/examples/wan30-product-reference.jpg"
]
}Envía cualquiera de los dos payloads a POST /api/v1/video-studio/generate/ con tu clave de API de UlazAI.
Consultar una tarea
curl -X GET '/api/v1/video-studio/status/{job_id}/' \
-H 'Authorization: Bearer YOUR_API_KEY'La respuesta contiene success y job. Lee job.status para el progreso y, una vez completado, las URLs de video de job.result_urls.