// Erros
Códigos de erro
Respostas seguem o formato JSON da OpenAI: { error: { message, type, code } }. Os códigos abaixo são os mais frequentes.
| Código | Significado | Como corrigir |
|---|---|---|
401 | Authentication error - chave inválida, expirada ou bloqueada. | Verifique a chave em /app/keys. Se estiver bloqueada, desbloqueie ou gere uma nova. |
403 | Forbidden - chave sem permissão para o modelo solicitado. | A chave pode ter uma allowlist de modelos. Edite a chave em /app/keys ou tente outro modelo. |
429 | Rate limit - RPM ou TPM excedido. | Espere alguns segundos e tente novamente, ou aumente o limite na configuração da chave. |
402 | ExceededBudget - saldo da chave ou da conta zerou. | Faça top-up em /app/billing ou ajuste o teto da chave em /app/keys. |
500 | Erro interno no proxy. | Tente novamente. Se persistir, abra um ticket pelo suporte. |
502 | Bad Gateway - provider upstream indisponível. | Geralmente transiente. O proxy faz 2 retries automáticos com backoff. Tente novamente em alguns segundos. |