Erros

HTTP	Significado	Ação recomendada
400	Solicitação inválida	JSON correto e campos obrigatórios
401	Chave inválida, congelada ou revogada	Gire ou descongele a chave
402	Saldo de conta insuficiente ou limite de uso de chave atingido	Adicione fundos ou redefina/aumente o limite da chave
403	Modelo indisponível para a chave ou IP de origem rejeitado por uma lista de permissões de API	Atualize as permissões de chave ou use um IP de origem permitido
404	Endpoint, modelo ou solicitação assíncrona desconhecido	Verifique o identificador e o caminho
413	Solicitação muito grande	Reduza o tamanho do contexto
429	RPM ou simultaneidade excedida	Honra Retry-After
500	Erro de gateway	Tente novamente e inspecione os registros
502/503/504	Upstream indisponível ou expirou	Tentar novamente com espera exponencial

Pagamento necessário

Saldo insuficiente da empresa/conta retorna HTTP 402 Payment Required no envelope compatível com OpenAI:

{
  "error": {
    "message": "Insufficient account balance.",
    "type": "payment_required",
    "code": "insufficient_balance"
  }
}

O mesmo motivo/código estável é registrado no Histórico de solicitações. UM 402 a solicitação é rejeitada antes da execução pelo fornecedor e não deve ser repetida automaticamente até que o financiamento ou a restrição de gastos aplicável tenham sido corrigidos.

Rejeição da lista de permissões de IP

Quando uma chave de API autenticada é válida, mas o endereço de origem está fora da lista de permissões de API pessoal ou empresarial efetiva, o Model Gate rejeita a solicitação antes da execução upstream. As respostas compatíveis com OpenAI usam HTTP 403 com código ip_not_allowed. Respostas compatíveis com Antrópico usam o envelope de erro Antrópico com HTTP 403 e authentication_error. Não tente novamente a partir da mesma fonte não permitida; altere a lista de permissões configurada ou envie a solicitação de um endereço permitido.

Tentar novamente 429 depois Retry-After. Tentar novamente 500, 502, 503, e 504 até três vezes com espera de 1/2/4 segundo. Não tente novamente validação, autenticação, saldo ou erros não encontrados automaticamente.

Use o ID público da solicitação de X-Request-ID correlacionar a resposta com o registro de solicitação.