Erros, retentativas e limites

Live

Classifique as falhas antes de repetir e preserve o contexto da requisição original.

(opens in new tab)Última verificação: 2026-08-11

Classes de erro

Status	Significado	Ação
400 / 413	Entrada inválida ou requisição grande demais	Corrija a requisição; não repita sem alterar
401	Chave ausente ou inválida	Rotacione ou corrija as credenciais
402	Limite de cobrança ou de crédito	Resolva a cobrança antes de repetir
429	Limite de uso atingido	Respeite o Retry-After e aplique backoff
5xx	Falha transitória do serviço ou do provedor	Repita um número limitado de vezes

Política de retentativas

Use backoff exponencial com jitter, um número máximo pequeno de tentativas e um prazo global. Preserve os IDs de requisição e os corpos de erro, mas remova credenciais e entradas sensíveis.

Limites de payload

Valide contagem de caracteres, quantidade de arquivos, bytes e compatibilidade do modelo antes de enviar. Leia os limites pela descoberta de modelos quando disponíveis. O histórico de chat não é descartado silenciosamente: corpos de requisição que ultrapassam o limite de bytes do gateway devolvem request_too_large, e o estouro de contexto do modelo devolve context_length_exceeded.

AnteriorWebhooks

PróximaRetenção de dados