Documentos do desenvolvedor UlazAI
Wan 3.0 Video API
Referência do Wan 3.0
Criar tarefas de Wan 3.0 video
Envie as requisições para POST /api/v1/video-studio/generate/ com
wan_3_0_video ou wan_3_0_video_prime como o slug do modelo.
Acompanhe o progresso com GET /api/v1/video-studio/status/{job_id}/.
Criar
POST /api/v1/video-studio/generate/
GET /api/v1/video-studio/status/{job_id}/
Modelos
wan_3_0_video
wan_3_0_video_prime
Saída
2-30 segundos
480P, 720P ou 1080P
Parâmetros
| Campo | Tipo | Limites e combinações |
|---|---|---|
model_slug | string | wan_3_0_video ou wan_3_0_video_prime. |
prompt | string | Máximo de 20,000 caracteres. |
duration_seconds | integer | 2-30. Com vídeo de referência, a duração da entrada mais a duração da saída precisa ficar abaixo de 30 segundos. |
quality_mode | string | 480p, 720p ou 1080p. |
aspect_ratio | string | adaptive, 16:9, 4:3, 1:1, 3:4 ou 9:16. |
sound | boolean | Ativado por padrão. O áudio nativo é gerado junto com o vídeo. |
first_frame_url | string | JPEG, PNG, WebP ou BMP. Cada lado 240-8000 px, proporção até 8:1, máximo de 20 MB. Não pode ser combinado com imagens de referência, um link ou um ficheiro. |
last_frame_url | string | Mesmos limites de imagem do primeiro quadro. Não pode ser combinado com imagens de referência, um link ou um arquivo. |
reference_image_urls | array | Máximo de 10 imagens. Não pode ser combinado com o primeiro ou o último fotograma. |
reference_video_urls | array | Máximo de 5 ficheiros MP4 ou MOV, 1-15 segundos cada, 15 segundos no total, máximo de 100 MB cada. A duração do vídeo de entrada somada à duração do vídeo de saída não pode exceder 30 segundos. |
reference_audio_urls | array | Máximo de 5 ficheiros WAV ou MP3, 1-15 segundos cada, 15 segundos no total, máximo de 15 MB cada. |
Tarifas de créditos por segundo
Os segundos do vídeo de referência e os segundos de saída solicitados são ambos cobrados.
| Resolução | 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 |
Criar uma tarefa
Texto para 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
}Imagens de referência para vídeo
{
"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"
]
}Envie qualquer um dos payloads para POST /api/v1/video-studio/generate/ com a sua chave de API da UlazAI.
Fazer polling de uma tarefa
curl -X GET '/api/v1/video-studio/status/{job_id}/' \
-H 'Authorization: Bearer YOUR_API_KEY'A resposta contém success e job. Leia job.status para o progresso e, após a conclusão, as URLs de vídeo de job.result_urls.