Accueil / Guides / Quota de l'API Gemini dépassé (429 RESOURCE_EXHAUSTED)

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.
  • quotaMetric indique ce qui a été épuisé. generate_content_free_tier_requests compte les requêtes de l'offre gratuite.
  • quotaId indique la fenêtre. PerDay désigne le quota quotidien. Un identifiant PerMinute désigne la limite par minute.
  • limit est votre quota pour ce modèle dans cette fenêtre.
  • Please retry in indique 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é :

D'après la page des erreurs de l'API Gemini
CodeHTTPSignificationSolution
rate_limit_exceeded429Limite de requêtes ou de jetons par minute ou par seconde atteinteRelancez avec un délai exponentiel
quota_exceeded429Quota quotidien épuiséAttendez la réinitialisation, ou demandez une augmentation
too_many_requests429Trop de requêtes dans une courte fenêtreRelancez avec un délai exponentiel
permission_denied403Le projet est restreint, ou l'offre gratuite n'y est pas disponibleAssociez 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.

Limites gratuites de Gemini et Gemma dans le catalogue actuel
ModèleGratuit surContexteLimites gratuites (meilleure offre)OutilsVision
Gemini 3.8 FlashGoogle AI Studio1MRecurring provider quotaOuiOui
Gemini Flash (latest alias)Google AI Studio-10 req/min
20 req/jour
250,000 jetons/min
~3M
OuiOui
Gemini 3.7 FlashGoogle AI Studio1M10 req/min
20 req/jour
250,000 jetons/min
~3M
OuiOui
Gemini 3.6 FlashGoogle AI Studio1M10 req/min
20 req/jour
250,000 jetons/min
~3M
OuiOui
Gemini 3.5 FlashGoogle AI Studio1M10 req/min
20 req/jour
250,000 jetons/min
~3M
OuiOui
Gemini 3.8 LiveGoogle AI Studio-10 req/min
20 req/jour
250,000 jetons/min
~3M
OuiOui
Gemini 3.8 Live Extended ThinkingGoogle AI Studio-10 req/min
20 req/jour
250,000 jetons/min
~3M
OuiOui
Gemini 3.8 Flash TTSGoogle AI Studio-Ongoing AI Studio free-tier quota; account limits applyNonNon
Gemini 3.8 Flash-Lite TTSGoogle AI Studio-Ongoing AI Studio free-tier quota; account limits applyNonNon
Gemini Robotics-ER 2 PreviewGoogle AI Studio131K10 req/min
20 req/jour
250,000 jetons/min
~3M
NonOui
Gemini 3.5 Flash LiteGoogle AI Studio1M15 req/min
20 req/jour
250,000 jetons/min
~3M
OuiOui
Gemini Flash Lite (latest alias)Google AI Studio-10 req/min
20 req/jour
250,000 jetons/min
~3M
OuiOui

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

  1. Lisez le quotaId. S'il contient PerDay, arrêtez-vous et attendez la réinitialisation à minuit, heure du Pacifique.
  2. Pour une limite par minute, relancez avec un délai exponentiel et une gigue. Définissez un nombre maximal de tentatives.
  3. Déplacez les tâches simples vers un modèle au plafond quotidien plus élevé, par exemple un modèle Gemma ou Flash-Lite.
  4. Envoyez moins de jetons. Les grands prompts atteignent vite la limite de jetons par minute.
  5. N'utilisez pas un max_tokens très petit. Gemini Flash peut utiliser des jetons de raisonnement cachés dans la limite de sortie.
Ce que vous essayezCela aide-t-il ?Pourquoi
Créer une nouvelle clé d'API dans le même projetNonLes limites s'appliquent au projet. Google indique qu'une nouvelle clé ne résout pas l'erreur.
Passer le projet à l'offre payanteDonne un quota payantGoogle 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 inOui, pour les limites par minuteLa fenêtre de la minute se renouvelle
Changer de modèleOuiChaque 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-Trail liste chaque saut échoué, par exemple google/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

FournisseurProblème connuQue faire
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.

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.

Utilisez chacun de ces modèles avec une seule clé. FreeLLMAPI est un routeur open source auto-hébergé. Il place toutes ces offres gratuites derrière un seul point de terminaison compatible OpenAI, et bascule vers une autre offre lorsqu'une limite de débit est atteinte. Parcourir le catalogue ou passer en production.

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

Sources

Tous les guides · Parcourir tous les modèles gratuits