RESOURCE_EXHAUSTED è il 429 generico di Gemini. Se si risolve dopo un minuto, hai raggiunto un limite di frequenza: il backoff risolve il problema. Se dura fino a mezzanotte del Pacifico, hai esaurito una quota giornaliera del piano gratuito: nessun ciclo di retry può risolverlo; servono la fatturazione o un percorso diverso.
L’errore
{
"error": {
"code": 429,
"message": "Resource has been exhausted (e.g. check quota).",
"status": "RESOURCE_EXHAUSTED"
}
}Cause e soluzioni in breve
| Causa | Soluzione |
|---|---|
| Limite di frequenza al minuto (RPM/TPM) | Usa il backoff con jitter; distribuisce i picchi. Si risolve entro ~60s. |
| Quota giornaliera di richieste del piano gratuito esaurita | Attendi il ripristino giornaliero — abilita la fatturazione, aumenta la quota o instrada il traffico tramite un gateway a pagamento. |
| Molti worker condividono una chiave | La quota è per progetto, non per worker: centralizza un rate limiter oppure distribuisci il carico tra progetti/chiavi. |
Classifica: limite al minuto o quota giornaliera
Ripeti una volta dopo 60 secondi. Successo → limite di frequenza su scala dei minuti (aggiungi il backoff e prosegui). Ancora 429 → quota giornaliera; controlla Cloud Console → Quotas per il contatore esatto al 100%.
Per i limiti al minuto: il backoff standard
Lo stesso schema di ogni 429: esponenziale, con jitter, e retry solo per gli stati ripetibili. Riutilizza senza modifiche lo snippet della nostra guida al 429 di Claude: è indipendente dal provider.
Per le quote giornaliere: cambia l'economia
Le quote del piano gratuito servono per la prototipazione. La produzione richiede la fatturazione abilitata sul progetto oppure un gateway pay-as-you-go, dove il limite è il tuo budget, non un contatore giornaliero. Confronta il calcolo per token prima di scegliere.
Se chiami tramite Kunavo
Su Kunavo, Gemini 2.5 Flash/Pro è pay-as-you-go con un unico portafoglio prepagato: non c'è alcun contatore giornaliero del piano gratuito da esaurire e le richieste fallite non vengono addebitate. Per i carichi di lavoro che continuano a superare le quote giornaliere di AI Studio, il prezzo per token (molto inferiore al listino Google) è solitamente più economico del tempo di progettazione speso per distribuire il carico tra i progetti.
Domande frequenti
Quando viene ripristinata la quota del piano gratuito Gemini?
Le quote giornaliere vengono ripristinate a mezzanotte del Pacifico. I limiti al minuto vengono ripristinati su una finestra mobile di 60 secondi.
Il backoff risolve RESOURCE_EXHAUSTED?
Solo nel caso del limite al minuto. Una quota giornaliera esaurita restituisce 429 a ogni retry fino al ripristino: rileva il caso (429 persistente dopo un'attesa di 60s) e interrompi i retry inutili.
Guide correlate
Ulteriori dettagli sul significato degli errori sono disponibili in riferimento agli errori; ottenere una chiave richiede un minuto tramite registrazione e la guida all’autenticazione.