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.quotaMetricindica che cosa si è esaurito.generate_content_free_tier_requestsconta le richieste del piano gratuito.quotaIdindica la finestra.PerDayè la quota giornaliera. Un idPerMinuteè il limite al minuto.limitè la tua quota per quel modello in quella finestra.Please retry inindica 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:
| Codice | HTTP | Significato | Soluzione |
|---|---|---|---|
rate_limit_exceeded | 429 | Limite di richieste o token al minuto o al secondo raggiunto | Riprova con backoff esponenziale |
quota_exceeded | 429 | Quota giornaliera esaurita | Attendi il reset, oppure richiedi un aumento |
too_many_requests | 429 | Troppe richieste in una finestra breve | Riprova con backoff esponenziale |
permission_denied | 403 | Il progetto è limitato, oppure il piano gratuito non è disponibile per esso | Collega 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.
| Modello | Gratis su | Contesto | Limiti gratuiti (offerta migliore) | Strumenti | Visione |
|---|---|---|---|---|---|
| Gemini 3.8 Flash | Google AI Studio | 1M | Recurring provider quota | Sì | Sì |
| Gemini Flash (latest alias) | Google AI Studio | - | 10 richieste/min 20 richieste/giorno 250,000 token/min ~3M | Sì | Sì |
| Gemini 3.7 Flash | Google AI Studio | 1M | 10 richieste/min 20 richieste/giorno 250,000 token/min ~3M | Sì | Sì |
| Gemini 3.6 Flash | Google AI Studio | 1M | 10 richieste/min 20 richieste/giorno 250,000 token/min ~3M | Sì | Sì |
| Gemini 3.5 Flash | Google AI Studio | 1M | 10 richieste/min 20 richieste/giorno 250,000 token/min ~3M | Sì | Sì |
| Gemini 3.8 Live | Google AI Studio | - | 10 richieste/min 20 richieste/giorno 250,000 token/min ~3M | Sì | Sì |
| Gemini 3.8 Live Extended Thinking | Google AI Studio | - | 10 richieste/min 20 richieste/giorno 250,000 token/min ~3M | Sì | Sì |
| Gemini 3.8 Flash TTS | Google AI Studio | - | Ongoing AI Studio free-tier quota; account limits apply | No | No |
| Gemini 3.8 Flash-Lite TTS | Google AI Studio | - | Ongoing AI Studio free-tier quota; account limits apply | No | No |
| Gemini Robotics-ER 2 Preview | Google AI Studio | 131K | 10 richieste/min 20 richieste/giorno 250,000 token/min ~3M | No | Sì |
| Gemini 3.5 Flash Lite | Google AI Studio | 1M | 15 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
- Leggi il
quotaId. Se contienePerDay, fermati e attendi il reset a mezzanotte, ora del Pacifico. - Per un limite al minuto, riprova con backoff esponenziale e jitter. Imposta un numero massimo di tentativi.
- Sposta i compiti semplici su un modello con un tetto giornaliero più alto, per esempio un modello Gemma o Flash-Lite.
- Invia meno token. I prompt lunghi raggiungono in fretta il limite di token al minuto.
- Non usare un
max_tokensmolto piccolo. Gemini Flash può usare token di ragionamento nascosti dentro il tetto dell'output.
| Cosa provi | Aiuta? | Perché |
|---|---|---|
| Creare una nuova chiave API nello stesso progetto | No | I limiti si applicano al progetto. Google dice che una nuova chiave non risolve l'errore. |
| Passare il progetto al piano a pagamento | Dà quota a pagamento | Google dice che il piano a pagamento non dà la quota del piano gratuito. L'uso a pagamento viene fatturato. |
Attendere il tempo di retry in | Sì, per i limiti al minuto | La finestra al minuto si rinnova |
| Passare a un modello diverso | Sì | 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-Trailelenca ogni passaggio fallito, per esempiogoogle/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
| Provider | Problema noto | Cosa fare |
|---|---|---|
| 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. |
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.
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
- Rate limit delle Free LLM API
- free gemini api
- Gemini CLI con endpoint personalizzato e modelli gratuiti
- Limite di frequenza Groq raggiunto (429)
- Limite di rate dell'API NVIDIA NIM
Fonti
- Google AI Studio: Rate limits (verificato il 20 November 2026)
- Google AI Studio: API errors (verificato il 20 November 2026)
- Google AI Studio: Troubleshooting (verificato il 20 November 2026)
- Google developer forum: free tier quota error example (verificato il 20 November 2026)
- FreeLLMAPI docs: Quota and cooldown engine (verificato il 20 November 2026)
- FreeLLMAPI docs: Response headers (verificato il 20 November 2026)