Home / Guide / Quota Gemini API superata (429 RESOURCE_EXHAUSTED)

Quota Gemini API superata (429 RESOURCE_EXHAUSTED)

L'API Gemini restituisce 429 RESOURCE_EXHAUSTED quando superi un limite di frequenza o una quota giornaliera. Nel piano gratuito, i limiti sono bassi. Questa pagina spiega ogni forma dell'errore, i limiti gratuiti attuali e le soluzioni che funzionano.

Codice, nomi dei modelli ed etichette del catalogo in tempo reale sono mostrati in inglese.

Com'è l'errore

Un tipico errore del piano gratuito, pubblicato sul forum per sviluppatori di Google, ha queste parti:

Esempio di 429 dal piano 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 indica che cosa si è esaurito. generate_content_free_tier_requests conta le richieste del piano gratuito.
  • quotaId indica la finestra. PerDay è la quota giornaliera. Un id PerMinute è il limite al minuto.
  • limit è la tua quota per quel modello in quella finestra.
  • Please retry in indica il tempo di attesa suggerito da Google.

I tre codici 429 e un 403

La pagina degli errori API di Google elenca tre codici di errore con HTTP 429 e un 403 correlato:

Dalla pagina degli errori dell'API Gemini
CodiceHTTPSignificatoSoluzione
rate_limit_exceeded429Limite di richieste o token al minuto o al secondo raggiuntoRiprova con backoff esponenziale
quota_exceeded429Quota giornaliera esauritaAttendi il reset, oppure richiedi un aumento
too_many_requests429Troppe richieste in una finestra breveRiprova con backoff esponenziale
permission_denied403Il progetto è limitato, oppure il piano gratuito non è disponibile per essoCollega un account di fatturazione e usa il piano a pagamento

Un limite al minuto si azzera in meno di un minuto. Una quota giornaliera si azzera solo al reset. Google reimposta le richieste giornaliere a mezzanotte, ora del Pacifico. Riprovare un errore di quota giornaliera prima del reset spreca richieste.

Limiti del piano gratuito oggi

Google applica i limiti a ogni progetto Google Cloud, non a ogni chiave. I limiti cambiano per ogni modello. Google mostra i tuoi limiti attivi in AI Studio. La tabella mostra i limiti del piano gratuito di Gemini e Gemma nel catalogo FreeLLMAPI.

Limiti gratuiti di Gemini e Gemma dal catalogo di oggi
ModelloGratis suContestoLimiti gratuiti (offerta migliore)StrumentiVisione
Gemini 3.8 FlashGoogle AI Studio1MRecurring provider quotaSìSì
Gemini Flash (latest alias)Google AI Studio-10 richieste/min
20 richieste/giorno
250,000 token/min
~3M
SìSì
Gemini 3.7 FlashGoogle AI Studio1M10 richieste/min
20 richieste/giorno
250,000 token/min
~3M
SìSì
Gemini 3.6 FlashGoogle AI Studio1M10 richieste/min
20 richieste/giorno
250,000 token/min
~3M
SìSì
Gemini 3.5 FlashGoogle AI Studio1M10 richieste/min
20 richieste/giorno
250,000 token/min
~3M
SìSì
Gemini 3.8 LiveGoogle AI Studio-10 richieste/min
20 richieste/giorno
250,000 token/min
~3M
SìSì
Gemini 3.8 Live Extended ThinkingGoogle AI Studio-10 richieste/min
20 richieste/giorno
250,000 token/min
~3M
SìSì
Gemini 3.8 Flash TTSGoogle AI Studio-Ongoing AI Studio free-tier quota; account limits applyNoNo
Gemini 3.8 Flash-Lite TTSGoogle AI Studio-Ongoing AI Studio free-tier quota; account limits applyNoNo
Gemini Robotics-ER 2 PreviewGoogle AI Studio131K10 richieste/min
20 richieste/giorno
250,000 token/min
~3M
NoSì
Gemini 3.5 Flash LiteGoogle AI Studio1M15 richieste/min
20 richieste/giorno
250,000 token/min
~3M
SìSì
Gemini Flash Lite (latest alias)Google AI Studio-10 richieste/min
20 richieste/giorno
250,000 token/min
~3M
SìSì

Mostrati 12 di 21 modelli gratuiti corrispondenti. Vedi tutti i modelli.

Dati in tempo reale dal catalogo FreeLLMAPI (versione 2026.11.19, verificato il 2026-11-19). I limiti gratuiti cambiano spesso. Il catalogo viene verificato ogni giorno.

La maggior parte dei modelli Flash consente circa 20 richieste al giorno nel piano gratuito. I modelli Gemma consentono molte più richieste al giorno, ma hanno una finestra di contesto più piccola. Google dice che i limiti indicati non sono garantiti e che la capacità effettiva può variare.

Soluzioni che funzionano

  1. Leggi il quotaId. Se contiene PerDay, fermati e attendi il reset a mezzanotte, ora del Pacifico.
  2. Per un limite al minuto, riprova con backoff esponenziale e jitter. Imposta un numero massimo di tentativi.
  3. Sposta i compiti semplici su un modello con un tetto giornaliero più alto, per esempio un modello Gemma o Flash-Lite.
  4. Invia meno token. I prompt lunghi raggiungono in fretta il limite di token al minuto.
  5. Non usare un max_tokens molto piccolo. Gemini Flash può usare token di ragionamento nascosti dentro il tetto dell'output.
Cosa proviAiuta?Perché
Creare una nuova chiave API nello stesso progettoNoI limiti si applicano al progetto. Google dice che una nuova chiave non risolve l'errore.
Passare il progetto al piano a pagamentoDà quota a pagamentoGoogle dice che il piano a pagamento non dà la quota del piano gratuito. L'uso a pagamento viene fatturato.
Attendere il tempo di retry inSì, per i limiti al minutoLa finestra al minuto si rinnova
Passare a un modello diversoSìOgni modello ha la sua quota

Controlla la quota prima di inviare

Puoi vedere il problema prima dell'errore. In AI Studio, apri la pagina dei limiti di frequenza dalla documentazione delle API Gemini. Mostra i limiti attivi del tuo progetto per ogni modello. La pagina Projects mostra il tuo piano.

Se usi FreeLLMAPI, chiedi al gateway quali modelli sono pronti ora. Un modello con lo stato exhausted ha chiavi che sono tutte in cooldown. Quello stato si azzera da solo quando finiscono i cooldown.

Elenca i modelli che possono rispondere ora

curl "http://localhost:3001/v1/models?execution_status=ready" \
  -H "Authorization: Bearer <unified-key>"

Pianifica l'uso giornaliero con numeri semplici. Con 20 richieste al giorno, un modello Flash ti dà circa una richiesta ogni 72 minuti per tutta la giornata. Un agente di programmazione può usare 20 richieste per un solo task. Usa i modelli Flash solo per i compiti difficili, e invia i compiti semplici a modelli con tetti giornalieri più alti.

Passa ad altri provider gratuiti

Con circa 20 richieste Flash al giorno, una sola chiave Gemini non basta per il lavoro da agente. FreeLLMAPI mette Gemini dietro un unico endpoint con altri provider gratuiti. Quando Gemini invia un 429, il router invia la richiesta al modello successivo nella tua catena.

  • Il router conta RPM, RPD, TPM e TPD per ogni modello e chiave. Si ferma prima di raggiungere un limite noto.
  • Un 429 breve mette la chiave in cooldown per 90 secondi. Una quota giornaliera esaurita usa un cooldown più lungo: 2 minuti, 10 minuti, 1 ora, poi 24 ore.
  • Se Google indica un tempo di attesa più lungo, il router usa il valore di Google.
  • L'intestazione X-Fallback-Trail elenca ogni passaggio fallito, per esempio google/gemini-2.5-flash key1=rate_limited.

Invia il traffico Gemini attraverso il 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"}]}'

Gemini CLI può anche usare la superficie nativa /v1beta del gateway. Il gateway non aggiunge quota Gemini. Usa altri provider quando Gemini è al limite.

Particolarità note di Gemini

ProviderProblema notoCosa fare
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.

Dati in tempo reale dal catalogo FreeLLMAPI (versione 2026.11.19, verificato il 2026-11-19). I limiti gratuiti cambiano spesso. Il catalogo viene verificato ogni giorno.

Usa ognuno di questi modelli con una sola chiave. FreeLLMAPI è un router open source self-hosted che mette tutti questi piani gratuiti dietro un unico endpoint compatibile con OpenAI e passa al successivo quando uno raggiunge il limite di frequenza. Sfoglia il catalogo oppure inizia.

Domande frequenti

Cosa significa 429 RESOURCE_EXHAUSTED nell'API Gemini?

Significa che il tuo progetto ha superato un limite di frequenza o una quota. Il quotaId nel corpo dell'errore indica se è un limite al minuto o una quota giornaliera.

Quando si azzera la quota del piano gratuito di Gemini?

Le richieste giornaliere si azzerano a mezzanotte, ora del Pacifico. I limiti al minuto si azzerano entro un minuto.

Perché una nuova chiave API Gemini non risolve l'errore di quota?

Google applica i limiti al progetto Google Cloud, non alla chiave. Ogni chiave nello stesso progetto condivide la stessa quota.

Cosa significa limit: 0 in un errore di quota Gemini?

Significa che il tuo progetto non ha quota gratuita per quel modello in quella finestra. Alcuni progetti non sono idonei al piano gratuito. Controlla i tuoi limiti in AI Studio oppure prova un modello diverso.

Come evito gli errori 429 di Gemini in un agente di programmazione?

Usa più provider gratuiti dietro un unico gateway. Quando Gemini raggiunge il suo limite, il gateway invia la richiesta a un altro provider, così l'agente continua.

Guide correlate

Fonti

Tutte le guide · Sfoglia tutti i modelli gratuiti