Gemini API-quota overschreden (429 RESOURCE_EXHAUSTED)
De Gemini API geeft 429 RESOURCE_EXHAUSTED terug wanneer u een snelheidslimiet of een dagquota overschrijdt. Op het gratis niveau zijn de limieten klein. Deze pagina legt elke vorm van de fout uit, de actuele gratis limieten en de oplossingen die werken.
Code, modelnamen en labels uit de live catalogus worden in het Engels getoond.
Hoe de fout eruitziet
Een typische fout op het gratis niveau, zoals geplaatst op het ontwikkelaarsforum van Google, heeft deze onderdelen:
Voorbeeld van 429 op het gratis niveau
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.quotaMetricvertelt wat op is.generate_content_free_tier_requeststelt aanvragen op het gratis niveau.quotaIdvertelt het tijdvenster.PerDayis het dagquota. Een id metPerMinuteis de limiet per minuut.limitis uw quota voor dat model in dat venster.Please retry ingeeft de wachttijd die Google voorstelt.
De drie 429-codes en één 403
De pagina met API-fouten van Google noemt drie foutcodes met HTTP 429, en een verwante 403:
| Code | HTTP | Betekenis | Oplossing |
|---|---|---|---|
rate_limit_exceeded | 429 | Limiet voor aanvragen of tokens per minuut of per seconde bereikt | Opnieuw proberen met exponentieel uitstel |
quota_exceeded | 429 | Dagquota is op | Wacht op de reset, of vraag een verhoging aan |
too_many_requests | 429 | Te veel aanvragen in een kort venster | Opnieuw proberen met exponentieel uitstel |
permission_denied | 403 | Het project is beperkt, of het gratis niveau is er niet beschikbaar | Koppel een factuuraccount en gebruik het betaalde niveau |
Een limiet per minuut verloopt in minder dan één minuut. Een dagquota verloopt pas bij de reset. Google reset aanvragen per dag om middernacht Pacifische tijd. Een dagquotafout opnieuw proberen voor de reset kost alleen aanvragen.
Limieten van het gratis niveau van nu
Google past limieten toe op elk Google Cloud-project, niet op elke sleutel. Limieten verschillen per model. Google toont uw actieve limieten in AI Studio. De tabel toont de gratis limieten van Gemini en Gemma in de FreeLLMAPI-catalogus.
| Model | Gratis op | Context | Gratis limieten (beste aanbod) | Tools | Vision |
|---|---|---|---|---|---|
| Gemini 3.8 Flash | Google AI Studio | 1M | Recurring provider quota | Ja | Ja |
| Gemini Flash (latest alias) | Google AI Studio | - | 10 aanvragen/min 20 aanvragen/dag 250,000 tokens/min ~3M | Ja | Ja |
| Gemini 3.7 Flash | Google AI Studio | 1M | 10 aanvragen/min 20 aanvragen/dag 250,000 tokens/min ~3M | Ja | Ja |
| Gemini 3.6 Flash | Google AI Studio | 1M | 10 aanvragen/min 20 aanvragen/dag 250,000 tokens/min ~3M | Ja | Ja |
| Gemini 3.5 Flash | Google AI Studio | 1M | 10 aanvragen/min 20 aanvragen/dag 250,000 tokens/min ~3M | Ja | Ja |
| Gemini 3.8 Live | Google AI Studio | - | 10 aanvragen/min 20 aanvragen/dag 250,000 tokens/min ~3M | Ja | Ja |
| Gemini 3.8 Live Extended Thinking | Google AI Studio | - | 10 aanvragen/min 20 aanvragen/dag 250,000 tokens/min ~3M | Ja | Ja |
| Gemini 3.8 Flash TTS | Google AI Studio | - | Ongoing AI Studio free-tier quota; account limits apply | Nee | Nee |
| Gemini 3.8 Flash-Lite TTS | Google AI Studio | - | Ongoing AI Studio free-tier quota; account limits apply | Nee | Nee |
| Gemini Robotics-ER 2 Preview | Google AI Studio | 131K | 10 aanvragen/min 20 aanvragen/dag 250,000 tokens/min ~3M | Nee | Ja |
| Gemini 3.5 Flash Lite | Google AI Studio | 1M | 15 aanvragen/min 20 aanvragen/dag 250,000 tokens/min ~3M | Ja | Ja |
| Gemini Flash Lite (latest alias) | Google AI Studio | - | 10 aanvragen/min 20 aanvragen/dag 250,000 tokens/min ~3M | Ja | Ja |
Toont 12 van 21 overeenkomende gratis modellen. Bekijk alle modellen.
Actuele gegevens uit de FreeLLMAPI-catalogus (versie 2026.11.19, gecontroleerd 2026-11-19). Gratis limieten veranderen vaak. De catalogus wordt elke dag gecontroleerd.
De meeste Flash-modellen staan ongeveer 20 aanvragen per dag toe op het gratis niveau. Gemma-modellen staan veel meer aanvragen per dag toe, maar hebben een kleiner contextvenster. Google zegt dat de opgegeven limieten niet gegarandeerd zijn en dat de werkelijke capaciteit kan verschillen.
Oplossingen die werken
- Lees de
quotaId. Als diePerDaybevat, stop dan en wacht op de reset om middernacht Pacifische tijd. - Voor een limiet per minuut probeert u opnieuw met exponentieel uitstel en jitter. Stel een maximumaantal pogingen in.
- Verplaats eenvoudige taken naar een model met een hogere dagelijkse limiet, bijvoorbeeld een Gemma- of Flash-Lite-model.
- Stuur minder tokens. Grote prompts bereiken snel de limiet van tokens per minuut.
- Gebruik geen heel kleine
max_tokens. Gemini Flash kan verborgen denk-tokens gebruiken binnen de limiet van de uitvoer.
| Wat u probeert | Helpt het? | Waarom |
|---|---|---|
| Maak een nieuwe API-sleutel in hetzelfde project | Nee | Limieten gelden voor het project. Google zegt dat een nieuwe sleutel de fout niet oplost. |
| Upgrade het project naar het betaalde niveau | Geeft betaald quota | Google zegt dat het betaalde niveau u geen quota van het gratis niveau geeft. Betaald gebruik wordt gefactureerd. |
Wacht op de tijd retry in | Ja, voor limieten per minuut | Het minuutvenster schuift door |
| Wissel naar een ander model | Ja | Elk model heeft zijn eigen quota |
Controleer uw quota voordat u verstuurt
U kunt het probleem zien voordat de fout optreedt. Open in AI Studio de pagina met snelheidslimieten uit de documentatie van de Gemini API. Die toont de actieve limieten van uw project per model. De pagina Projects toont uw niveau.
Als u FreeLLMAPI gebruikt, vraagt u de gateway welke modellen nu klaar zijn. Een model met de status exhausted heeft sleutels die allemaal in cooldown zitten. Die status verdwijnt vanzelf wanneer de cooldowns eindigen.
Modellen tonen die nu kunnen antwoorden
curl "http://localhost:3001/v1/models?execution_status=ready" \
-H "Authorization: Bearer <unified-key>"Plan uw dagelijks gebruik met eenvoudige getallen. Bij 20 aanvragen per dag geeft één Flash-model ongeveer één aanvraag per 72 minuten over een volle dag. Een codeeragent kan 20 aanvragen voor één taak gebruiken. Zet de Flash-modellen alleen in voor moeilijke taken, en stuur eenvoudige taken naar modellen met hogere dagelijkse limieten.
Overschakelen naar andere gratis aanbieders
Met ongeveer 20 Flash-aanvragen per dag is één Gemini-sleutel niet genoeg voor agentwerk. FreeLLMAPI zet Gemini achter één eindpunt samen met andere gratis aanbieders. Wanneer Gemini een 429 stuurt, stuurt de router de aanvraag naar het volgende model in uw keten.
- De router telt RPM, RPD, TPM en TPD voor elk model en elke sleutel. Het stopt voordat het een bekende limiet bereikt.
- Een korte 429 zet de sleutel in een cooldown van 90 seconden. Een volledig dagquota krijgt een langere cooldown: 2 minuten, 10 minuten, 1 uur, en daarna 24 uur.
- Als Google een langere wachttijd geeft, gebruikt de router de waarde van Google.
- De header
X-Fallback-Trailtoont elke mislukte stap, bijvoorbeeldgoogle/gemini-2.5-flash key1=rate_limited.
Gemini-verkeer via de gateway sturen
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 kan ook de native /v1beta-interface van de gateway gebruiken. De gateway voegt geen Gemini-quota toe. Het gebruikt andere aanbieders wanneer Gemini zijn limiet heeft bereikt.
Bekende eigenaardigheden van Gemini
| Aanbieder | Bekend probleem | Wat u kunt doen |
|---|---|---|
| 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. |
Actuele gegevens uit de FreeLLMAPI-catalogus (versie 2026.11.19, gecontroleerd 2026-11-19). Gratis limieten veranderen vaak. De catalogus wordt elke dag gecontroleerd.
Veelgestelde vragen
Wat betekent 429 RESOURCE_EXHAUSTED in de Gemini API?
Het betekent dat uw project een snelheidslimiet of een quota heeft overschreden. De quotaId in de fouttekst vertelt u of het een limiet per minuut of een dagquota is.
Wanneer wordt het quota van het gratis niveau van Gemini gereset?
Aanvragen per dag worden gereset om middernacht Pacifische tijd. Limieten per minuut worden binnen één minuut gereset.
Waarom lost een nieuwe Gemini API-sleutel de quotafout niet op?
Google past limieten toe op het Google Cloud-project, niet op de sleutel. Elke sleutel in hetzelfde project deelt hetzelfde quota.
Wat betekent limit: 0 in een Gemini-quotafout?
Het betekent dat uw project geen gratis quota heeft voor dat model in dat venster. Sommige projecten komen niet in aanmerking voor het gratis niveau. Controleer uw limieten in AI Studio of probeer een ander model.
Hoe voorkom ik Gemini-fouten 429 in een codeeragent?
Gebruik meerdere gratis aanbieders achter één gateway. Wanneer Gemini zijn limiet bereikt, stuurt de gateway de aanvraag naar een andere aanbieder, zodat de agent doorgaat.
Gerelateerde gidsen
- Rate limits van de gratis LLM API
- free gemini api
- Gemini CLI met een eigen eindpunt en gratis modellen
- Groq-limiet bereikt (429)
- NVIDIA NIM API-rate limit
Bronnen
- Google AI Studio: Rate limits (gecontroleerd 20 November 2026)
- Google AI Studio: API errors (gecontroleerd 20 November 2026)
- Google AI Studio: Troubleshooting (gecontroleerd 20 November 2026)
- Google developer forum: free tier quota error example (gecontroleerd 20 November 2026)
- FreeLLMAPI docs: Quota and cooldown engine (gecontroleerd 20 November 2026)
- FreeLLMAPI docs: Response headers (gecontroleerd 20 November 2026)