Resposta rápida
- wan3.0-video suporta Text-to-Video, Image-to-Video, R2V e Video Edit em um único fluxo.
- Use esta página de guia do modelo para validar parâmetros com exemplos mínimos de requisição e resposta.
- Estabilize primeiro os prompts aqui e depois passe para a integração com a API de produção.
Parâmetros principais
- model | string | obrigatório | wan3.0-video | - | Identificador do modelo. Use o valor fixo `wan3.0-video`.
- prompt | string | obrigatório | - | - | Instrução principal que descreve o sujeito, a ação, a cena e o estilo.
- aspect_ratio | string | opcional | 16:9 | 16:9 | 9:16 | Proporção do vídeo. Padrão `16:9`; aceita `16:9 | 9:16`.
- duration | integer | opcional | 5 | -1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13 | 14 | 15 | 16 | 17 | 18 | 19 | 20 | 21 | 22 | 23 | 24 | 25 | 26 | 27 | 28 | 29 | 30 | Duração da saída em segundos. Padrão `5`; aceita `-1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13 | 14 | 15 | 16 | 17 | 18 | 19 | 20 | 21 | 22 | 23 | 24 | 25 | 26 | 27 | 28 | 29 | 30`, onde `-1` significa automático.
- resolution | string | opcional | 1080p | 480p | 720p | 1080p | Resolução da saída. Padrão `1080p`; aceita `480p | 720p | 1080p`.
Erros comuns
- 400 invalid_request_error: gatilho=O payload da requisição não inclui campos obrigatórios ou tem tipos de campo inválidos.; correção=Valide model, mode e o esquema de input antes de enviar.; nova tentativa=Tente novamente apenas após corrigir o payload; evite novas tentativas cegas.
- 401 authentication_error: gatilho=O cabeçalho Authorization está ausente ou a chave de API é inválida.; correção=Verifique o formato do token Bearer e o escopo da chave de API.; nova tentativa=Tente novamente após corrigir a autenticação; rotacione a chave se as falhas se repetirem.
- 429 rate_limit_exceeded: gatilho=A frequência de requisições, a concorrência ou a cota atual acionam o limite do provedor.; correção=Aplique primeiro um recuo exponencial e depois revise o ritmo de requisições, a concorrência e o uso da cota.; nova tentativa=Use backoff exponencial (por exemplo, 1s/2s/4s) com jitter; se persistir, reduza a pressão de envio.
- 500 internal_error: gatilho=Erro transitório do provedor ou falha interna de processamento.; correção=Registre o request id e acione o fluxo de novas tentativas.; nova tentativa=Tente novamente 2 a 3 vezes com intervalos curtos; escale se o problema persistir.







