# 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.

Por IsAnythingDown. Revisado 2026-10-06.

Página canônica: https://isanythingdown.com/pt/guides/ai-api-error-429

## 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.

- [Códigos de erro da OpenAI API](https://developers.openai.com/api/docs/guides/error-codes)
- [Erros da Claude API](https://platform.claude.com/docs/en/api/errors)
- [Solução de problemas de Gemini API](https://ai.google.dev/gemini-api/docs/troubleshooting)

## 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.

- [Como interpretar erros de API de IA](https://isanythingdown.com/pt/guides/ai-api-error-codes)

## Páginas de serviços relacionados

- [OpenAI API](https://isanythingdown.com/pt/services/openai)
- [Claude](https://isanythingdown.com/pt/services/claude)
- [Gemini API / AI Studio](https://isanythingdown.com/pt/services/gemini-api)
- [OpenRouter](https://isanythingdown.com/pt/services/openrouter)

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.