Quota de l'API Gemini dépassé (429 RESOURCE_EXHAUSTED)
L'API Gemini renvoie 429 RESOURCE_EXHAUSTED lorsque vous dépassez une limite de débit ou un quota quotidien. Dans l'offre gratuite, les limites sont faibles. Cette page explique chaque forme de l'erreur, les limites gratuites actuelles et les corrections qui fonctionnent.
Le code, les noms de modèles et les libellés du catalogue en direct sont affichés en anglais.
À quoi ressemble l'erreur
Une erreur typique de l'offre gratuite, publiée sur le forum des développeurs de Google, contient ces éléments :
Exemple d'erreur 429 de l'offre gratuite
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.quotaMetricindique ce qui a été épuisé.generate_content_free_tier_requestscompte les requêtes de l'offre gratuite.quotaIdindique la fenêtre.PerDaydésigne le quota quotidien. Un identifiantPerMinutedésigne la limite par minute.limitest votre quota pour ce modèle dans cette fenêtre.Please retry inindique le délai d'attente que Google suggère.
Les trois codes 429 et un 403
La page des erreurs de l'API Google répertorie trois codes d'erreur avec HTTP 429, et un 403 associé :
| Code | HTTP | Signification | Solution |
|---|---|---|---|
rate_limit_exceeded | 429 | Limite de requêtes ou de jetons par minute ou par seconde atteinte | Relancez avec un délai exponentiel |
quota_exceeded | 429 | Quota quotidien épuisé | Attendez la réinitialisation, ou demandez une augmentation |
too_many_requests | 429 | Trop de requêtes dans une courte fenêtre | Relancez avec un délai exponentiel |
permission_denied | 403 | Le projet est restreint, ou l'offre gratuite n'y est pas disponible | Associez un compte de facturation et utilisez l'offre payante |
Une limite par minute se libère en moins d'une minute. Un quota quotidien ne se libère qu'à la réinitialisation. Google réinitialise les requêtes quotidiennes à minuit, heure du Pacifique. Relancer une erreur de quota quotidien avant la réinitialisation gaspille des requêtes.
Limites de l'offre gratuite aujourd'hui
Google applique les limites à chaque projet Google Cloud, et non à chaque clé. Les limites diffèrent selon le modèle. Google affiche vos limites actives dans AI Studio. Le tableau présente les limites gratuites de Gemini et Gemma dans le catalogue FreeLLMAPI.
| Modèle | Gratuit sur | Contexte | Limites gratuites (meilleure offre) | Outils | Vision |
|---|---|---|---|---|---|
| Gemini 3.8 Flash | Google AI Studio | 1M | Recurring provider quota | Oui | Oui |
| Gemini Flash (latest alias) | Google AI Studio | - | 10 req/min 20 req/jour 250,000 jetons/min ~3M | Oui | Oui |
| Gemini 3.7 Flash | Google AI Studio | 1M | 10 req/min 20 req/jour 250,000 jetons/min ~3M | Oui | Oui |
| Gemini 3.6 Flash | Google AI Studio | 1M | 10 req/min 20 req/jour 250,000 jetons/min ~3M | Oui | Oui |
| Gemini 3.5 Flash | Google AI Studio | 1M | 10 req/min 20 req/jour 250,000 jetons/min ~3M | Oui | Oui |
| Gemini 3.8 Live | Google AI Studio | - | 10 req/min 20 req/jour 250,000 jetons/min ~3M | Oui | Oui |
| Gemini 3.8 Live Extended Thinking | Google AI Studio | - | 10 req/min 20 req/jour 250,000 jetons/min ~3M | Oui | Oui |
| Gemini 3.8 Flash TTS | Google AI Studio | - | Ongoing AI Studio free-tier quota; account limits apply | Non | Non |
| Gemini 3.8 Flash-Lite TTS | Google AI Studio | - | Ongoing AI Studio free-tier quota; account limits apply | Non | Non |
| Gemini Robotics-ER 2 Preview | Google AI Studio | 131K | 10 req/min 20 req/jour 250,000 jetons/min ~3M | Non | Oui |
| Gemini 3.5 Flash Lite | Google AI Studio | 1M | 15 req/min 20 req/jour 250,000 jetons/min ~3M | Oui | Oui |
| Gemini Flash Lite (latest alias) | Google AI Studio | - | 10 req/min 20 req/jour 250,000 jetons/min ~3M | Oui | Oui |
Affichage de 12 modèles gratuits sur 21 correspondants. Voir tous les modèles.
Données en direct du catalogue FreeLLMAPI (version 2026.11.19, vérifié le 2026-11-19). Les limites gratuites changent souvent. Le catalogue est vérifié chaque jour.
La plupart des modèles Flash autorisent environ 20 requêtes par jour dans l'offre gratuite. Les modèles Gemma autorisent beaucoup plus de requêtes par jour, mais leur fenêtre de contexte est plus petite. Google indique que les limites annoncées ne sont pas garanties et que la capacité réelle peut varier.
Corrections qui fonctionnent
- Lisez le
quotaId. S'il contientPerDay, arrêtez-vous et attendez la réinitialisation à minuit, heure du Pacifique. - Pour une limite par minute, relancez avec un délai exponentiel et une gigue. Définissez un nombre maximal de tentatives.
- Déplacez les tâches simples vers un modèle au plafond quotidien plus élevé, par exemple un modèle Gemma ou Flash-Lite.
- Envoyez moins de jetons. Les grands prompts atteignent vite la limite de jetons par minute.
- N'utilisez pas un
max_tokenstrès petit. Gemini Flash peut utiliser des jetons de raisonnement cachés dans la limite de sortie.
| Ce que vous essayez | Cela aide-t-il ? | Pourquoi |
|---|---|---|
| Créer une nouvelle clé d'API dans le même projet | Non | Les limites s'appliquent au projet. Google indique qu'une nouvelle clé ne résout pas l'erreur. |
| Passer le projet à l'offre payante | Donne un quota payant | Google indique que l'offre payante ne vous donne pas le quota de l'offre gratuite. L'usage payant est facturé. |
Attendre le délai retry in | Oui, pour les limites par minute | La fenêtre de la minute se renouvelle |
| Changer de modèle | Oui | Chaque modèle a son propre quota |
Vérifier votre quota avant l'envoi
Vous pouvez voir le problème avant l'erreur. Dans AI Studio, ouvrez la page des limites de débit depuis la documentation de l'API Gemini. Elle affiche les limites actives de votre projet pour chaque modèle. La page Projects indique votre palier.
Si vous utilisez FreeLLMAPI, demandez à la passerelle quels modèles sont prêts maintenant. Un modèle au statut exhausted a des clés qui sont toutes en délai d'attente. Ce statut disparaît tout seul à la fin des délais.
Lister les modèles qui peuvent répondre maintenant
curl "http://localhost:3001/v1/models?execution_status=ready" \
-H "Authorization: Bearer <unified-key>"Planifiez votre usage quotidien avec des chiffres simples. À 20 requêtes par jour, un modèle Flash vous donne environ une requête toutes les 72 minutes sur une journée complète. Un agent de développement peut utiliser 20 requêtes pour une seule tâche. Réservez les modèles Flash aux tâches difficiles, et envoyez les tâches simples aux modèles au plafond quotidien plus élevé.
Basculer vers d'autres fournisseurs gratuits
Avec environ 20 requêtes Flash par jour, une seule clé Gemini ne suffit pas pour le travail d'agent. FreeLLMAPI place Gemini derrière un seul point de terminaison, avec d'autres fournisseurs gratuits. Lorsque Gemini renvoie un 429, le routeur envoie la requête au modèle suivant de votre chaîne.
- Le routeur compte les RPM, RPD, TPM et TPD pour chaque modèle et chaque clé. Il s'arrête avant d'atteindre une limite connue.
- Un 429 court place la clé en délai d'attente de 90 secondes. Un quota quotidien épuisé entraîne un délai plus long : 2 minutes, 10 minutes, 1 heure, puis 24 heures.
- Si Google donne un délai de nouvelle tentative plus long, le routeur utilise la valeur de Google.
- L'en-tête
X-Fallback-Trailliste chaque saut échoué, par exemplegoogle/gemini-2.5-flash key1=rate_limited.
Envoyer le trafic Gemini par la passerelle
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 peut aussi utiliser la surface native /v1beta de la passerelle. La passerelle n'ajoute pas de quota Gemini. Elle utilise d'autres fournisseurs lorsque Gemini est à sa limite.
Particularités connues de Gemini
| Fournisseur | Problème connu | Que faire |
|---|---|---|
| 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. |
Données en direct du catalogue FreeLLMAPI (version 2026.11.19, vérifié le 2026-11-19). Les limites gratuites changent souvent. Le catalogue est vérifié chaque jour.
Questions fréquentes
Que signifie 429 RESOURCE_EXHAUSTED dans l'API Gemini ?
Cela signifie que votre projet a dépassé une limite de débit ou un quota. Le quotaId dans le corps de l'erreur indique s'il s'agit d'une limite par minute ou d'un quota quotidien.
Quand le quota de l'offre gratuite Gemini se réinitialise-t-il ?
Les requêtes par jour se réinitialisent à minuit, heure du Pacifique. Les limites par minute se réinitialisent en moins d'une minute.
Pourquoi une nouvelle clé d'API Gemini ne corrige-t-elle pas l'erreur de quota ?
Google applique les limites au projet Google Cloud, et non à la clé. Toutes les clés d'un même projet partagent le même quota.
Que signifie limit: 0 dans une erreur de quota Gemini ?
Cela signifie que votre projet n'a aucun quota gratuit pour ce modèle dans cette fenêtre. Certains projets ne sont pas éligibles à l'offre gratuite. Vérifiez vos limites dans AI Studio, ou essayez un autre modèle.
Comment éviter les erreurs 429 de Gemini dans un agent de développement ?
Utilisez plusieurs fournisseurs gratuits derrière une seule passerelle. Lorsque Gemini atteint sa limite, la passerelle envoie la requête à un autre fournisseur, et l'agent continue.
Guides associés
- Limites de débit des API LLM gratuites
- free gemini api
- Gemini CLI avec un point de terminaison personnalisé et des modèles gratuits
- Limite de débit Groq atteinte (429)
- Limite de débit de l'API NVIDIA NIM
Sources
- Google AI Studio: Rate limits (vérifié le 20 November 2026)
- Google AI Studio: API errors (vérifié le 20 November 2026)
- Google AI Studio: Troubleshooting (vérifié le 20 November 2026)
- Google developer forum: free tier quota error example (vérifié le 20 November 2026)
- FreeLLMAPI docs: Quota and cooldown engine (vérifié le 20 November 2026)
- FreeLLMAPI docs: Response headers (vérifié le 20 November 2026)