Início / Guias / Cota da API Gemini excedida (429 RESOURCE_EXHAUSTED)

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.
  • quotaMetric informa o que se esgotou. generate_content_free_tier_requests conta as requisições do plano gratuito.
  • quotaId informa a janela. PerDay é a cota diária. Um id PerMinute é o limite por minuto.
  • limit é a sua cota para esse modelo nessa janela.
  • Please retry in informa 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:

Da página de erros da API Gemini
CódigoHTTPSignificadoCorreção
rate_limit_exceeded429Limite de requisições ou de tokens por minuto ou por segundo atingidoTente de novo com recuo exponencial
quota_exceeded429Cota diária esgotadaEspere a renovação, ou solicite um aumento
too_many_requests429Requisições demais em uma janela curtaTente de novo com recuo exponencial
permission_denied403O projeto está restrito, ou o plano gratuito não está disponível para eleVincule 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.

Limites gratuitos do Gemini e do Gemma no catálogo de hoje
ModeloGratuito emContextoLimites gratuitos (melhor oferta)FerramentasVisão
Gemini 3.8 FlashGoogle AI Studio1MRecurring provider quotaSimSim
Gemini Flash (latest alias)Google AI Studio-10 req/min
20 req/dia
250,000 tokens/min
~3M
SimSim
Gemini 3.7 FlashGoogle AI Studio1M10 req/min
20 req/dia
250,000 tokens/min
~3M
SimSim
Gemini 3.6 FlashGoogle AI Studio1M10 req/min
20 req/dia
250,000 tokens/min
~3M
SimSim
Gemini 3.5 FlashGoogle AI Studio1M10 req/min
20 req/dia
250,000 tokens/min
~3M
SimSim
Gemini 3.8 LiveGoogle AI Studio-10 req/min
20 req/dia
250,000 tokens/min
~3M
SimSim
Gemini 3.8 Live Extended ThinkingGoogle AI Studio-10 req/min
20 req/dia
250,000 tokens/min
~3M
SimSim
Gemini 3.8 Flash TTSGoogle AI Studio-Ongoing AI Studio free-tier quota; account limits applyNãoNão
Gemini 3.8 Flash-Lite TTSGoogle AI Studio-Ongoing AI Studio free-tier quota; account limits applyNãoNão
Gemini Robotics-ER 2 PreviewGoogle AI Studio131K10 req/min
20 req/dia
250,000 tokens/min
~3M
NãoSim
Gemini 3.5 Flash LiteGoogle AI Studio1M15 req/min
20 req/dia
250,000 tokens/min
~3M
SimSim
Gemini Flash Lite (latest alias)Google AI Studio-10 req/min
20 req/dia
250,000 tokens/min
~3M
SimSim

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

  1. Leia o quotaId. Se ele contiver PerDay, pare e espere a renovação à meia-noite, no horário do Pacífico.
  2. Para um limite por minuto, tente de novo com recuo exponencial e jitter. Defina um número máximo de novas tentativas.
  3. Mova tarefas simples para um modelo com um teto diário maior, por exemplo um modelo Gemma ou Flash-Lite.
  4. Envie menos tokens. Prompts grandes atingem o limite de tokens por minuto rapidamente.
  5. Não use um max_tokens muito pequeno. O Gemini Flash pode usar tokens de raciocínio ocultos dentro do limite de saída.
O que você tentaAjuda?Por quê
Criar uma nova chave de API no mesmo projetoNãoOs limites se aplicam ao projeto. O Google diz que uma nova chave não resolve o erro.
Mudar o projeto para o plano pagoDá cota pagaO Google diz que o plano pago não dá cota do plano gratuito. O uso pago é cobrado.
Esperar o tempo de retry inSim, para limites por minutoA janela de um minuto se renova
Trocar para outro modeloSimCada 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-Trail lista cada salto que falhou, por exemplo google/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

ProvedorProblema conhecidoO que fazer
Google AI StudioThinking tokens use output capGemini 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.

Use todos estes modelos com uma única chave. FreeLLMAPI é um roteador de código aberto e de hospedagem própria. Ele coloca todas estas camadas gratuitas atrás de um único endpoint compatível com OpenAI e passa para o próximo provedor quando um deles está com limite de requisições. Ver o catálogo ou colocar em produção.

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

Fontes

Todos os guias · Ver todos os modelos gratuitos