Operação
Erros
Formato do erro, códigos e como tratar cada um.
Erros seguem o formato da OpenAI e sempre trazem o cabeçalho x-request-id:
JSON
{
"error": {
"message": "Saldo insuficiente.",
"type": "invalid_request_error",
"param": null,
"code": "insufficient_credits"
}
}| Status | code | O que fazer |
|---|---|---|
| 400 | invalid_request | Corrija o corpo: campo inválido, desconhecido ou fora dos limites. |
| 400 | invalid_token_limit | Envie só max_tokens ou só max_completion_tokens. |
| 400 | invalid_stream_options | stream_options exige stream=true. |
| 401 | invalid_api_key | Chave ausente, inválida, expirada ou revogada. |
| 402 | insufficient_credits | Adicione créditos ou reduza max_completion_tokens. |
| 402 | key_budget | O orçamento da chave acabou. Ajuste-o no console. |
| 403 | key_forbidden | A chave não tem o escopo necessário. |
| 404 | model_not_found | Confira o ID em GET /models. |
| 413 | payload_too_large | Reduza o corpo para menos de 256 KiB. |
| 422 | context_limit | Encurte a conversa ou o limite de saída. |
| 422 | unsupported_capability | Endpoint ou recurso não disponível na ISC. |
| 429 | rate_limit / concurrency_limit | Aguarde o Retry-After e tente de novo. |
| 502 | upstream_failure | Falha no fornecedor. Pode repetir; reservas não usadas são liberadas. |
| 503 | maintenance / provider_circuit_open | Indisponibilidade temporária. Tente em instantes. |
| 504 | upstream_timeout | O fornecedor demorou demais. Tente de novo ou reduza a saída. |
Suporte
Ao abrir um chamado em contato, informe o
x-request-id. Ele identifica a chamada sem expor a sua chave.