Documentação

Erros / Limites de requisição

Erros

Erros de requisição retornam um objeto contendo code e message. Uma tarefa aceita com sucesso ainda pode falhar posteriormente durante o processamento; monitore seu status por consulta ou configure um callback de falha.

{
  "error": {
    "code": "invalid_request",
    "message": "input.prompt is required."
  }
}

HTTP	Campo	O que fazer
400	`invalid_request`	Corrija a estrutura do JSON, prompts ausentes, intervalos de parâmetros ou URLs de mídia antes de tentar novamente.
401	`invalid_api_key`	Verifique o token Bearer e se a chave de API continua ativa.
402	`insufficient_credits`	Adicione créditos à conta ou reduza o custo da geração. A resposta pode indicar os saldos necessário e disponível.
403	`forbidden`	Verifique a restrição aplicada à conta descrita na mensagem de erro.
404	`not_found`	Confirme se o ID da tarefa está correto e se ela foi criada pela mesma chave de API utilizada.
429	`rate_limited`	Aguarde o tempo indicado no cabeçalho Retry-After antes de realizar novas tentativas.
500	`internal_error`	Examine a mensagem de erro e os logs da API. Reenvie com cautela; novas tentativas de criação geram novas cobranças.

Limites de requisição

Criação de tarefas: por padrão, cada chave de API permite até 100 requisições por minuto. No momento, limites personalizados não estão disponíveis.

Consulta de tarefas: por padrão, cada chave de API permite até 120 requisições por minuto. As requisições de consulta e de criação de tarefas são contabilizadas separadamente.

As requisições de criação de imagem e vídeo compartilham o mesmo limite de taxa (rate limit) da chave de API.

Respostas com HTTP 429 incluem o cabeçalho Retry-After: 60 para criação e Retry-After: 5 para consultas. Implemente recuo gradual (backoff) e evite consultas mais frequentes do que o recomendado.

HTTP/1.1 429 Too Many Requests
Content-Type: application/json
Retry-After: 60

{
  "error": {
    "code": "rate_limited",
    "message": "Rate limit exceeded."
  }
}