Códigos de erro da API
Todos os erros que a API devolve, com o status HTTP, o código e o que fazer. Os erros usam o formato da OpenAI.
Erros
Os erros usam o formato da OpenAI: {"error": {"message", "type", "code"}}.
| HTTP | code | |
|---|---|---|
| 400 | invalid_request | O corpo não é um JSON válido, ou um campo está faltando ou errado. A mensagem diz qual. |
| 400 | wrong_endpoint | O modelo é de outro tipo: modelos de chat usam /chat/completions, de imagem /images/generations e de vídeo /videos. |
| 400 | size_not_available / format_not_available / too_many_images | O modelo de imagem não gera este tamanho ou formato de arquivo, ou recebeu mais imagens de entrada do que aceita. A mensagem informa o que ele aceita. |
| 400 | resolution_not_available | O modelo de vídeo não é vendido nesta resolução. |
| 400 | video_not_ready | O vídeo ainda não foi concluído; continue consultando GET /videos/{id}. |
| 400 | not_a_draft / draft_not_ready / draft_wrong_model / draft_expired | draft_id deve ser um rascunho concluído do mesmo modelo, feito nos últimos 7 dias. |
| 400 | user_required | Somente contas relay: toda requisição de chat deve ter um campo user. |
| 401 | invalid_api_key | Chave de API ausente, incorreta ou revogada. |
| 402 | insufficient_balance / key_spend_cap | Recarregue seu saldo, ou aumente o limite diário da chave. |
| 403 | account_inactive | A conta está suspensa. |
| 403 | ip_not_allowed | A chave tem uma lista de IPs permitidos e a requisição veio de outro endereço. |
| 404 | model_not_found | Id de modelo desconhecido. Veja GET /models. |
| 404 | video_not_found / draft_not_found | Não existe esse vídeo ou rascunho na sua conta. |
| 404 | video_expired / last_frame_expired / image_expired / no_last_frame | O arquivo não está mais guardado, ou o último quadro não foi pedido. Links de imagem duram 1 hora. Links de vídeo duram uma semana; um vídeo que não conseguimos copiar para o nosso armazenamento é servido pelo provedor do modelo por apenas 24 horas. |
| 404 | not_found | Esse caminho não existe. Veja Endpoints. |
| 405 | method_not_allowed | Método HTTP errado para este caminho, por exemplo GET em /chat/completions. |
| 413 | request_too_large | O corpo da requisição é grande demais. |
| 429 | rate_limit_exceeded / concurrency_limit / model_at_capacity | Diminua o ritmo e tente de novo após o tempo do cabeçalho Retry-After. |
| 429 | model_rate_limit_exceeded / model_concurrency_limit | Sua conta atingiu o limite para este modelo específico. Os outros modelos continuam funcionando; tente de novo após o tempo do Retry-After. |
| 429 | upstream_rate_limited | O próprio modelo está no limite de uso. Tente de novo em alguns segundos; você não foi cobrado. |
| 429 | too_many_failed_requests | A chave enviou muitas requisições com falha em sequência e fica pausada pelo tempo indicado em Retry-After. Corrija o erro que você estava recebendo e tente de novo. |
| 500 | internal_error | Algo falhou do nosso lado. Tente de novo e informe o request_id ao suporte se o erro se repetir. |
| 502 | upstream_error | O provedor do modelo falhou. É seguro tentar de novo; você não foi cobrado. |
| 503 | upstream_unavailable / billing_unavailable / config_unavailable / model_not_priced / gateway_draining | Temporário. Tente de novo com espera crescente. |
| 504 | upstream_error | O modelo não respondeu a tempo. É seguro tentar de novo; você não foi cobrado. |
