Cota da API Gemini excedida (429 RESOURCE_EXHAUSTED)
A API Gemini devolve 429 RESOURCE_EXHAUSTED quando você passa de um limite de taxa ou de uma cota diária. No plano gratuito, os limites são pequenos. Esta página explica cada forma do erro, os limites gratuitos atuais e as correções que funcionam.
O código, os nomes dos modelos e os rótulos do catálogo ao vivo são exibidos em inglês.
Como é o erro
Um erro típico do plano gratuito, como publicado no fórum de desenvolvedores do Google, tem estas partes:
Exemplo de 429 do plano gratuito
429 RESOURCE_EXHAUSTED
You exceeded your current quota, please check your plan and billing details.
Quota exceeded for metric: generativelanguage.googleapis.com/generate_content_free_tier_requests, limit: 50
quotaId: GenerateRequestsPerDayPerProjectPerModel-FreeTier
Please retry in 11.615098148s.quotaMetricinforma o que se esgotou.generate_content_free_tier_requestsconta as requisições do plano gratuito.quotaIdinforma a janela.PerDayé a cota diária. Um idPerMinuteé o limite por minuto.limité a sua cota para esse modelo nessa janela.Please retry ininforma o tempo de espera que o Google sugere.
Os três códigos 429 e um 403
A página de erros da API do Google lista três códigos de erro com HTTP 429, e um 403 relacionado:
| Código | HTTP | Significado | Correção |
|---|---|---|---|
rate_limit_exceeded | 429 | Limite de requisições ou de tokens por minuto ou por segundo atingido | Tente de novo com recuo exponencial |
quota_exceeded | 429 | Cota diária esgotada | Espere a renovação, ou solicite um aumento |
too_many_requests | 429 | Requisições demais em uma janela curta | Tente de novo com recuo exponencial |
permission_denied | 403 | O projeto está restrito, ou o plano gratuito não está disponível para ele | Vincule uma conta de faturamento e use o plano pago |
Um limite por minuto é liberado em menos de um minuto. Uma cota diária só é liberada na renovação. O Google renova as requisições diárias à meia-noite, no horário do Pacífico. Tentar de novo um erro de cota diária antes da renovação desperdiça requisições.
Limites do plano gratuito hoje
O Google aplica limites a cada projeto do Google Cloud, e não a cada chave. Os limites são diferentes para cada modelo. O Google mostra os seus limites ativos no AI Studio. A tabela mostra os limites gratuitos do Gemini e do Gemma no catálogo do FreeLLMAPI.
| Modelo | Gratuito em | Contexto | Limites gratuitos (melhor oferta) | Ferramentas | Visão |
|---|---|---|---|---|---|
| Gemini 3.8 Flash | Google AI Studio | 1M | Recurring provider quota | Sim | Sim |
| Gemini Flash (latest alias) | Google AI Studio | - | 10 req/min 20 req/dia 250,000 tokens/min ~3M | Sim | Sim |
| Gemini 3.7 Flash | Google AI Studio | 1M | 10 req/min 20 req/dia 250,000 tokens/min ~3M | Sim | Sim |
| Gemini 3.6 Flash | Google AI Studio | 1M | 10 req/min 20 req/dia 250,000 tokens/min ~3M | Sim | Sim |
| Gemini 3.5 Flash | Google AI Studio | 1M | 10 req/min 20 req/dia 250,000 tokens/min ~3M | Sim | Sim |
| Gemini 3.8 Live | Google AI Studio | - | 10 req/min 20 req/dia 250,000 tokens/min ~3M | Sim | Sim |
| Gemini 3.8 Live Extended Thinking | Google AI Studio | - | 10 req/min 20 req/dia 250,000 tokens/min ~3M | Sim | Sim |
| Gemini 3.8 Flash TTS | Google AI Studio | - | Ongoing AI Studio free-tier quota; account limits apply | Não | Não |
| Gemini 3.8 Flash-Lite TTS | Google AI Studio | - | Ongoing AI Studio free-tier quota; account limits apply | Não | Não |
| Gemini Robotics-ER 2 Preview | Google AI Studio | 131K | 10 req/min 20 req/dia 250,000 tokens/min ~3M | Não | Sim |
| Gemini 3.5 Flash Lite | Google AI Studio | 1M | 15 req/min 20 req/dia 250,000 tokens/min ~3M | Sim | Sim |
| Gemini Flash Lite (latest alias) | Google AI Studio | - | 10 req/min 20 req/dia 250,000 tokens/min ~3M | Sim | Sim |
Mostrando 12 de 21 modelos gratuitos correspondentes. Ver todos os modelos.
Dados ao vivo do catálogo FreeLLMAPI (versão 2026.11.19, verificado em 2026-11-19). Os limites gratuitos mudam com frequência. O catálogo é verificado todos os dias.
A maioria dos modelos Flash permite cerca de 20 requisições por dia no plano gratuito. Os modelos Gemma permitem bem mais requisições por dia, mas têm uma janela de contexto menor. O Google diz que os limites informados não são garantidos e que a capacidade real pode variar.
Correções que funcionam
- Leia o
quotaId. Se ele contiverPerDay, pare e espere a renovação à meia-noite, no horário do Pacífico. - Para um limite por minuto, tente de novo com recuo exponencial e jitter. Defina um número máximo de novas tentativas.
- Mova tarefas simples para um modelo com um teto diário maior, por exemplo um modelo Gemma ou Flash-Lite.
- Envie menos tokens. Prompts grandes atingem o limite de tokens por minuto rapidamente.
- Não use um
max_tokensmuito pequeno. O Gemini Flash pode usar tokens de raciocínio ocultos dentro do limite de saída.
| O que você tenta | Ajuda? | Por quê |
|---|---|---|
| Criar uma nova chave de API no mesmo projeto | Não | Os limites se aplicam ao projeto. O Google diz que uma nova chave não resolve o erro. |
| Mudar o projeto para o plano pago | Dá cota paga | O Google diz que o plano pago não dá cota do plano gratuito. O uso pago é cobrado. |
Esperar o tempo de retry in | Sim, para limites por minuto | A janela de um minuto se renova |
| Trocar para outro modelo | Sim | Cada modelo tem a sua própria cota |
Confira a sua cota antes de enviar
Você pode ver o problema antes do erro. No AI Studio, abra a página de limites de taxa da documentação da API Gemini. Ela mostra os limites ativos do seu projeto para cada modelo. A página Projects mostra o seu plano.
Se você usa o FreeLLMAPI, pergunte ao gateway quais modelos estão prontos agora. Um modelo com o status exhausted tem chaves que estão todas em período de espera. Esse status se limpa sozinho quando os períodos de espera terminam.
Listar os modelos que podem responder agora
curl "http://localhost:3001/v1/models?execution_status=ready" \
-H "Authorization: Bearer <unified-key>"Planeje o uso diário com números simples. Com 20 requisições por dia, um modelo Flash dá cerca de uma requisição a cada 72 minutos ao longo de um dia inteiro. Um agente de programação pode usar 20 requisições em uma única tarefa. Use os modelos Flash somente em tarefas difíceis, e envie tarefas simples para modelos com tetos diários maiores.
Troque para outros provedores gratuitos
Com cerca de 20 requisições Flash por dia, uma chave Gemini não basta para trabalho com agente. O FreeLLMAPI coloca o Gemini atrás de um endpoint junto com outros provedores gratuitos. Quando o Gemini envia um 429, o roteador envia a requisição para o próximo modelo da sua cadeia.
- O roteador conta RPM, RPD, TPM e TPD para cada modelo e chave. Ele para antes de atingir um limite conhecido.
- Um 429 curto coloca a chave em período de espera de 90 segundos. Uma cota diária esgotada usa um período de espera mais longo: 2 minutos, 10 minutos, 1 hora e depois 24 horas.
- Se o Google informar um tempo de nova tentativa maior, o roteador usa o valor do Google.
- O cabeçalho
X-Fallback-Traillista cada salto que falhou, por exemplogoogle/gemini-2.5-flash key1=rate_limited.
Envie o tráfego do Gemini pelo gateway
curl -fsSL https://freellmapi.co/install.sh | bash
curl -i http://localhost:3001/v1/chat/completions \
-H "Authorization: Bearer <unified-key>" \
-H "Content-Type: application/json" \
-d '{"model": "auto", "messages": [{"role": "user", "content": "hi"}]}'O Gemini CLI também pode usar a superfície nativa /v1beta do gateway. O gateway não adiciona cota do Gemini. Ele usa outros provedores quando o Gemini está no limite.
Particularidades conhecidas do Gemini
| Provedor | Problema conhecido | O que fazer |
|---|---|---|
| Google AI Studio | Thinking tokens use output cap | Gemini Flash can spend hidden thinking tokens inside maxOutputTokens. Avoid tiny max_tokens values or set thinkingBudget to 0 when provider support is available. |
Dados ao vivo do catálogo FreeLLMAPI (versão 2026.11.19, verificado em 2026-11-19). Os limites gratuitos mudam com frequência. O catálogo é verificado todos os dias.
Perguntas frequentes
O que 429 RESOURCE_EXHAUSTED significa na API Gemini?
Significa que o seu projeto passou de um limite de taxa ou de uma cota. O quotaId no corpo do erro informa se é um limite por minuto ou uma cota diária.
Quando a cota do plano gratuito do Gemini é renovada?
As requisições por dia são renovadas à meia-noite, no horário do Pacífico. Os limites por minuto são renovados em até um minuto.
Por que uma nova chave da API Gemini não corrige o erro de cota?
O Google aplica limites ao projeto do Google Cloud, e não à chave. Todas as chaves do mesmo projeto compartilham a mesma cota.
O que significa limit: 0 em um erro de cota do Gemini?
Significa que o seu projeto não tem cota gratuita para esse modelo nessa janela. Alguns projetos não são elegíveis para o plano gratuito. Confira os seus limites no AI Studio ou tente outro modelo.
Como evito erros 429 do Gemini em um agente de programação?
Use vários provedores gratuitos atrás de um gateway. Quando o Gemini atinge o limite, o gateway envia a requisição para outro provedor, e o agente continua.
Guias relacionados
- Limites de taxa da API LLM gratuita
- free gemini api
- Gemini CLI com endpoint personalizado e modelos gratuitos
- Limite de taxa da Groq atingido (429)
- Limite de taxa da API NVIDIA NIM
Fontes
- Google AI Studio: Rate limits (verificado em 20 November 2026)
- Google AI Studio: API errors (verificado em 20 November 2026)
- Google AI Studio: Troubleshooting (verificado em 20 November 2026)
- Google developer forum: free tier quota error example (verificado em 20 November 2026)
- FreeLLMAPI docs: Quota and cooldown engine (verificado em 20 November 2026)
- FreeLLMAPI docs: Response headers (verificado em 20 November 2026)