RESOURCE_EXHAUSTED é o 429 genérico do Gemini. Se desaparecer após um minuto, você atingiu um limite de taxa — o backoff resolve. Se durar até a meia-noite do Pacífico, você esgotou uma cota diária do nível gratuito — nenhum loop de novas tentativas resolverá isso; apenas cobrança ou outra rota podem resolver.
O erro
{
"error": {
"code": 429,
"message": "Resource has been exhausted (e.g. check quota).",
"status": "RESOURCE_EXHAUSTED"
}
}Causas e soluções em resumo
| Causa | Solução |
|---|---|
| Limite de taxa por minuto (RPM/TPM) | Use backoff com jitter; suavize os picos. É liberado em cerca de 60 s. |
| Cota diária de solicitações do nível gratuito esgotada | Aguarde até a redefinição diária — habilite a cobrança, aumente a cota ou roteie por um gateway pago. |
| Muitos workers compartilhando uma chave | A cota é por projeto, não por worker — centralize um limitador de taxa ou distribua entre projetos/chaves. |
Classifique: limite por minuto ou cota diária
Tente novamente uma vez após 60 segundos. Sucesso → limite de taxa em escala de minutos (adicione backoff e prossiga). Ainda 429 → cota diária; verifique Cloud Console → Quotas para identificar o contador exato que está em 100%.
Para limites por minuto: o backoff padrão
O mesmo padrão de todo 429 — exponencial, com jitter, tentando novamente apenas em status que permitem nova tentativa. Reutilize sem alterações o trecho do nosso guia de 429 do Claude; ele é independente do provedor.
Para cotas diárias: mude a economia
As cotas do nível gratuito servem para prototipagem. A produção precisa de cobrança habilitada no projeto — ou de um gateway pré-pago, em que o limite é sua carteira, não um contador diário. Compare o cálculo por token antes de escolher.
Se você estiver chamando pela Kunavo
No Kunavo, Gemini 2.5 Flash/Pro funciona no modelo pré-pago sob uma única carteira pré-paga — não há contador diário do nível gratuito a esgotar, e solicitações malsucedidas não são cobradas. Para cargas de trabalho que continuam atingindo as cotas diárias do AI Studio, o preço por token (bem abaixo da tabela do Google) costuma ser mais barato que o tempo de engenharia gasto distribuindo entre projetos.
Perguntas frequentes
Quando a cota do nível gratuito do Gemini é redefinida?
As cotas diárias são redefinidas à meia-noite, horário do Pacífico. Os limites por minuto são redefinidos em uma janela móvel de 60 segundos.
O backoff corrige RESOURCE_EXHAUSTED?
Apenas o tipo por minuto. Uma cota diária esgotada retorna 429 em todas as tentativas até a redefinição — detecte esse caso (429 persistindo após aguardar 60 s) e pare de desperdiçar tentativas.
Guias relacionados
Mais detalhes sobre o significado dos erros estão em referência de erros; obter uma chave leva um minuto por meio de cadastro e da guia de autenticação.