Resposta rápida
- flux-2-pro 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 | flux-2-pro | - | Identificador do modelo. Use o valor fixo `flux-2-pro`.
- 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 | 1:1 | Proporção do vídeo. Padrão `16:9`; aceita `16:9 | 9:16 | 1:1`.
- duration | integer | opcional | 6 | 5 | 10 | 15 | 20 | Duração da saída em segundos. Padrão `6`; aceita `5 | 10 | 15 | 20`.
- resolution | string | opcional | 720P | 720P | Resolução da saída. Padrão `720P`; aceita `720P`.
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.










