Erro 429 de API de IA: limites de solicitações, créditos e limites de gastos
Um 429 é uma resposta de limite de solicitações, não uma prova de interrupção do provedor. Leia o código de erro, a mensagem e os cabeçalhos de nova tentativa do provedor antes de tentar novamente.
Resposta rápida
Um 429 é uma resposta de limite de solicitações, não uma prova de interrupção do provedor. Leia o código de erro, a mensagem e os cabeçalhos de nova tentativa do provedor antes de tentar novamente.
O que cada provedor documenta
OpenAI distingue limites de frequência de solicitações, créditos esgotados e limites da organização ou projeto. Examine error.code; tentar novamente após um limite de cobrança ou uso não restaura o acesso.
Claude usa rate_limit_error para limites de solicitações e alguns limites de gastos. Uma resposta por limite de gastos do nível de uso não inclui cabeçalho retry-after. O crescimento rápido do tráfego também pode acionar limites de solicitações.
Gemini inclui 429 RESOURCE_EXHAUSTED entre os erros que podem justificar espera exponencial. Examine os detalhes do erro antes de tratar um limite como transitório.
Resposta recomendada do aplicativo
Reduza a concorrência de solicitações para um limite transitório, respeite o atraso de nova tentativa fornecido e defina um máximo de tentativas e um prazo total. Considere as tentativas já realizadas pelo SDK. A ausência de um cabeçalho de nova tentativa não identifica a causa por si só.
Preserve um corpo de erro sem dados sensíveis e o ID da solicitação. Verifique a configuração da conta em privado quando o erro indicar um limite de créditos ou gastos; não publique credenciais. Compare o escopo do status de API relevante com as evidências da solicitação.
Páginas de serviços relacionados
Cada entrada mostra sua própria cobertura de coleta. Um serviço com link não é necessariamente coletado automaticamente.
A data de revisão editorial se aplica a este guia. As horas de coleta dos relatórios atuais aparecem nas páginas dos serviços.