RESOURCE_EXHAUSTED est le code 429 générique de Gemini. S’il disparaît après une minute, vous avez atteint une limite de débit : le backoff suffit. S’il persiste jusqu’à minuit, heure du Pacifique, vous avez épuisé un quota quotidien gratuit : aucune boucle de nouvelle tentative ne peut résoudre le problème ; seuls la facturation ou un autre chemin peuvent le faire.
L’erreur
{
"error": {
"code": 429,
"message": "Resource has been exhausted (e.g. check quota).",
"status": "RESOURCE_EXHAUSTED"
}
}Causes et solutions en bref
| Cause | Solution |
|---|---|
| Limite de débit par minute (RPM/TPM) | Appliquez un backoff avec jitter et lissez les pics. La limite disparaît en ~60 s. |
| Quota quotidien de requêtes de l’offre gratuite épuisé | Attendez la réinitialisation quotidienne — activez la facturation, augmentez le quota ou acheminez les requêtes via une passerelle payante. |
| De nombreux workers partagent une même clé | Le quota s’applique au projet, pas au worker : centralisez un limiteur de débit ou répartissez la charge entre plusieurs projets/clés. |
Classifiez : limite par minute ou quota quotidien
Réessayez une fois après 60 secondes. Succès → limite de débit à l’échelle de la minute (ajoutez un backoff et poursuivez). Toujours 429 → quota quotidien ; consultez Cloud Console → Quotas pour identifier le compteur exact à 100 %.
Pour les limites par minute : le backoff standard
Même modèle que pour tout 429 : backoff exponentiel avec jitter, et nouvelles tentatives uniquement pour les statuts réessayables. Réutilisez sans modification l’extrait de notre guide sur les 429 de Claude ; il est indépendant du fournisseur.
Pour les quotas quotidiens : changez l’économie
Les quotas gratuits servent au prototypage. La production nécessite d’activer la facturation sur le projet — ou d’utiliser une passerelle à la consommation, où le plafond est votre budget et non un compteur quotidien. Comparez le coût par jeton avant de choisir.
Si vous appelez via Kunavo
Sur Kunavo, Gemini 2.5 Flash/Pro fonctionne à la consommation avec un seul portefeuille prépayé : aucun compteur quotidien gratuit ne peut être épuisé et les requêtes échouées ne sont pas facturées. Pour les charges qui atteignent sans cesse les quotas quotidiens d’AI Studio, le prix par jeton (nettement inférieur au tarif catalogue de Google) est généralement moins élevé que le temps d’ingénierie consacré à la répartition entre projets.
Questions fréquentes
Quand le quota de l’offre gratuite Gemini est-il réinitialisé ?
Les quotas quotidiens sont réinitialisés à minuit, heure du Pacifique. Les limites par minute sont réinitialisées selon une fenêtre glissante de 60 secondes.
Le backoff corrigera-t-il RESOURCE_EXHAUSTED ?
Uniquement pour la limite par minute. Un quota quotidien épuisé renvoie 429 à chaque nouvelle tentative jusqu’à la réinitialisation. Détectez ce cas (429 persistant après une attente de 60 s) et cessez de gaspiller des tentatives.
Guides associés
La sémantique détaillée des erreurs est disponible dans référence des erreurs ; obtenir une clé prend une minute via inscription et la guide d’authentification.