Erros
Os erros incluem um código legível por máquina e uma mensagem. Diferencie uma solicitação rejeitada de um resultado incerto que pode já ter usado capacidade do provedor.
Formato de erro
{
"error": {
"message": "Insufficient available credit for this request. Add credit or resolve pending reservations.",
"type": "invalid_request_error",
"code": "insufficient_credit"
}
}Use o x-request-id da resposta e os seus registros de atividade para investigar uma solicitação. Nunca inclua a chave secreta ou o conteúdo da conversa em um relatório de suporte.
Códigos de status
| Status | Significado / ação |
|---|---|
| 400 | Corpo inválido, campos desconhecidos, limite de contexto ou capacidade não suportada. |
| 401 | Chave Bearer ausente, inválida ou revogada. |
| 402 | Crédito disponível insuficiente ou limite de gastos da chave de API atingido. |
| 403 | Conta indisponível ou modelo fora da lista de permitidos da chave. |
| 404 | Endpoint desconhecido ou ID de modelo não aprovado. |
| 409 | Uma referência de idempotência já foi utilizada. |
| 413 / 415 | Corpo grande demais ou tipo de conteúdo diferente de application/json. |
| 429 | Limite de frequência, solicitações ou concorrência. Aguarde o intervalo de Retry-After antes de tentar novamente; reservas pendentes podem exigir conciliação. |
| 502 | Falha do provedor, fluxo inválido ou uso indisponível. |
| 503 | Manutenção, prontidão do provedor ou configuração de lançamento. |
Resultados incertos
Um tempo de espera esgotado do provedor ou uma resposta usage_unavailable pode deixar uma retenção pendente. Esses erros incluem X-Should-Retry: false para impedir repetições automáticas do SDK. Os códigos de falha do provedor distinguem modelos indisponíveis, parâmetros inválidos, autenticação, cota e limitação de solicitações sem retornar detalhes privados do provedor. Examine a atividade e concilie o primeiro resultado antes de decidir enviar uma nova chamada.
Idempotência
Uma Idempotency-Key opcional contém 1–128 letras, dígitos, pontos, sublinhados, dois-pontos ou hífens. Reutilizar uma referência retorna 409 e não executa a inferência novamente. Isso evita duplicações; não reproduz respostas em cache.