Resposta rápida
- viduq3-drama 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 | viduq3-drama | - | Identificador do modelo. Use o valor fixo `viduq3-drama`.
- 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 | 4:3 | 3:4 | 1:1 | Proporção do vídeo. Padrão `16:9`; aceita `16:9 | 9:16 | 4:3 | 3:4 | 1:1`.
- duration | integer | opcional | 5 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13 | 14 | 15 | Duração da saída em segundos. Padrão `5`; aceita `2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13 | 14 | 15`.
- resolution | string | opcional | 1080P | 1080P | Resolução da saída. Padrão `1080P`; aceita `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.







