Gemini-API-Kontingent überschritten (429 RESOURCE_EXHAUSTED)
Die Gemini API gibt 429 RESOURCE_EXHAUSTED zurück, wenn Sie ein Rate Limit oder ein tägliches Kontingent überschreiten. Im kostenlosen Tarif sind die Limits klein. Diese Seite erklärt jede Form des Fehlers, die aktuellen kostenlosen Limits und die Lösungen, die funktionieren.
Code, Modellnamen und Bezeichnungen aus dem Live-Katalog werden auf Englisch angezeigt.
So sieht der Fehler aus
Ein typischer Fehler im kostenlosen Tarif, wie er im Entwicklerforum von Google veröffentlicht wird, hat diese Teile:
Beispiel für einen Fehler 429 im kostenlosen Tarif
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.quotaMetriczeigt Ihnen, was aufgebraucht ist.generate_content_free_tier_requestszählt Anfragen im kostenlosen Tarif.quotaIdzeigt Ihnen das Zeitfenster.PerDayist das tägliche Kontingent. Eine IDPerMinuteist das Limit pro Minute.limitist Ihr Kontingent für dieses Modell in diesem Zeitfenster.Please retry ingibt die Wartezeit an, die Google vorschlägt.
Die drei Codes 429 und ein Code 403
Die Seite mit den API-Fehlern von Google listet drei Fehlercodes mit HTTP 429 und einen verwandten Fehler 403:
| Code | HTTP | Bedeutung | Lösung |
|---|---|---|---|
rate_limit_exceeded | 429 | Limit pro Minute oder pro Sekunde für Anfragen oder Token erreicht | Mit exponentiellem Backoff erneut versuchen |
quota_exceeded | 429 | Tägliches Kontingent aufgebraucht | Bis zum Zurücksetzen warten oder eine Erhöhung anfordern |
too_many_requests | 429 | Zu viele Anfragen in kurzer Zeit | Mit exponentiellem Backoff erneut versuchen |
permission_denied | 403 | Das Projekt ist eingeschränkt, oder der kostenlose Tarif ist dafür nicht verfügbar | Ein Abrechnungskonto verknüpfen und den kostenpflichtigen Tarif nutzen |
Ein Limit pro Minute setzt sich in weniger als einer Minute zurück. Ein tägliches Kontingent setzt sich nur beim Zurücksetzen zurück. Google setzt Anfragen pro Tag um Mitternacht pazifischer Zeit zurück. Ein erneuter Versuch bei einem Fehler des täglichen Kontingents vor dem Zurücksetzen verschwendet Anfragen.
Kostenlose Limits heute
Google wendet Limits auf jedes Google-Cloud-Projekt an, nicht auf jeden Schlüssel. Die Limits sind für jedes Modell unterschiedlich. Google zeigt Ihre aktiven Limits in AI Studio an. Die Tabelle zeigt die kostenlosen Limits von Gemini und Gemma im FreeLLMAPI-Katalog.
| Modell | Kostenlos bei | Kontext | Kostenlose Limits (bestes Angebot) | Tools | Bildverarbeitung |
|---|---|---|---|---|---|
| Gemini 3.8 Flash | Google AI Studio | 1M | Recurring provider quota | Ja | Ja |
| Gemini Flash (latest alias) | Google AI Studio | - | 10 Anfragen/Min. 20 Anfragen/Tag 250,000 Token/Min. ~3M | Ja | Ja |
| Gemini 3.7 Flash | Google AI Studio | 1M | 10 Anfragen/Min. 20 Anfragen/Tag 250,000 Token/Min. ~3M | Ja | Ja |
| Gemini 3.6 Flash | Google AI Studio | 1M | 10 Anfragen/Min. 20 Anfragen/Tag 250,000 Token/Min. ~3M | Ja | Ja |
| Gemini 3.5 Flash | Google AI Studio | 1M | 10 Anfragen/Min. 20 Anfragen/Tag 250,000 Token/Min. ~3M | Ja | Ja |
| Gemini 3.8 Live | Google AI Studio | - | 10 Anfragen/Min. 20 Anfragen/Tag 250,000 Token/Min. ~3M | Ja | Ja |
| Gemini 3.8 Live Extended Thinking | Google AI Studio | - | 10 Anfragen/Min. 20 Anfragen/Tag 250,000 Token/Min. ~3M | Ja | Ja |
| Gemini 3.8 Flash TTS | Google AI Studio | - | Ongoing AI Studio free-tier quota; account limits apply | Nein | Nein |
| Gemini 3.8 Flash-Lite TTS | Google AI Studio | - | Ongoing AI Studio free-tier quota; account limits apply | Nein | Nein |
| Gemini Robotics-ER 2 Preview | Google AI Studio | 131K | 10 Anfragen/Min. 20 Anfragen/Tag 250,000 Token/Min. ~3M | Nein | Ja |
| Gemini 3.5 Flash Lite | Google AI Studio | 1M | 15 Anfragen/Min. 20 Anfragen/Tag 250,000 Token/Min. ~3M | Ja | Ja |
| Gemini Flash Lite (latest alias) | Google AI Studio | - | 10 Anfragen/Min. 20 Anfragen/Tag 250,000 Token/Min. ~3M | Ja | Ja |
Es werden 12 von 21 passenden kostenlosen Modellen angezeigt. Alle Modelle ansehen.
Live-Daten aus dem FreeLLMAPI-Katalog (Version 2026.11.19, geprüft 2026-11-19). Kostenlose Limits ändern sich oft. Der Katalog wird jeden Tag geprüft.
Die meisten Flash-Modelle erlauben im kostenlosen Tarif etwa 20 Anfragen pro Tag. Gemma-Modelle erlauben deutlich mehr Anfragen pro Tag, haben aber ein kleineres Kontextfenster. Google sagt, dass die angegebenen Limits nicht garantiert sind und die tatsächliche Kapazität schwanken kann.
Lösungen, die funktionieren
- Lesen Sie die
quotaId. Enthält siePerDay, stoppen Sie und warten Sie bis zum Zurücksetzen um Mitternacht pazifischer Zeit. - Bei einem Limit pro Minute wiederholen Sie die Anfrage mit exponentiellem Backoff und Jitter. Legen Sie eine maximale Anzahl an Wiederholungen fest.
- Verlagern Sie einfache Aufgaben auf ein Modell mit höherer Tagesobergrenze, zum Beispiel ein Gemma- oder Flash-Lite-Modell.
- Senden Sie weniger Token. Große Prompts erreichen das Limit pro Minute für Token schnell.
- Verwenden Sie kein sehr kleines
max_tokens. Gemini Flash kann versteckte Denk-Token innerhalb der Ausgabegrenze verbrauchen.
| Was Sie versuchen | Hilft es? | Warum |
|---|---|---|
| Einen neuen API-Schlüssel im selben Projekt erstellen | Nein | Limits gelten für das Projekt. Google sagt, dass ein neuer Schlüssel den Fehler nicht behebt. |
| Das Projekt auf den kostenpflichtigen Tarif umstellen | Gibt kostenpflichtiges Kontingent | Google sagt, dass der kostenpflichtige Tarif Ihnen kein Kontingent des kostenlosen Tarifs gibt. Kostenpflichtige Nutzung wird abgerechnet. |
Die Zeit retry in abwarten | Ja, bei Limits pro Minute | Das Zeitfenster pro Minute wird zurückgesetzt |
| Auf ein anderes Modell wechseln | Ja | Jedes Modell hat ein eigenes Kontingent |
Prüfen Sie Ihr Kontingent, bevor Sie senden
Das Problem können Sie vor dem Fehler erkennen. Öffnen Sie in AI Studio die Seite zu den Rate Limits aus der Gemini-API-Dokumentation. Sie zeigt die aktiven Limits Ihres Projekts für jedes Modell. Die Seite Projects zeigt Ihren Tarif.
Wenn Sie FreeLLMAPI verwenden, fragen Sie das Gateway, welche Modelle jetzt bereit sind. Ein Modell mit dem Status exhausted hat Schlüssel, die alle in einer Abkühlzeit sind. Dieser Status endet von selbst, wenn die Abkühlzeiten vorbei sind.
Modelle auflisten, die jetzt antworten können
curl "http://localhost:3001/v1/models?execution_status=ready" \
-H "Authorization: Bearer <unified-key>"Planen Sie Ihre tägliche Nutzung mit einfachen Zahlen. Bei 20 Anfragen pro Tag ergibt ein Flash-Modell über einen ganzen Tag etwa eine Anfrage alle 72 Minuten. Ein Coding-Agent kann 20 Anfragen für eine einzige Aufgabe verbrauchen. Setzen Sie die Flash-Modelle nur für schwierige Aufgaben ein und senden Sie einfache Aufgaben an Modelle mit höheren täglichen Obergrenzen.
Auf andere kostenlose Anbieter ausweichen
Mit etwa 20 Flash-Anfragen pro Tag reicht ein Gemini-Schlüssel für Agentenarbeit nicht aus. FreeLLMAPI stellt Gemini zusammen mit anderen kostenlosen Anbietern hinter einem Endpunkt bereit. Sendet Gemini den Fehler 429, sendet der Router die Anfrage an das nächste Modell in Ihrer Kette.
- Der Router zählt RPM, RPD, TPM und TPD für jedes Modell und jeden Schlüssel. Er hält an, bevor er ein bekanntes Limit erreicht.
- Ein kurzer Fehler 429 setzt den Schlüssel für 90 Sekunden in eine Abkühlzeit. Ein aufgebrauchtes tägliches Kontingent führt zu längeren Abkühlzeiten: 2 Minuten, 10 Minuten, 1 Stunde und dann 24 Stunden.
- Gibt Google eine längere Wiederholungszeit an, verwendet der Router den Wert von Google.
- Der Header
X-Fallback-Traillistet jeden fehlgeschlagenen Schritt auf, zum Beispielgoogle/gemini-2.5-flash key1=rate_limited.
Gemini-Datenverkehr über das Gateway leiten
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 kann auch die native Schnittstelle /v1beta des Gateways nutzen. Das Gateway fügt kein Gemini-Kontingent hinzu. Es nutzt andere Anbieter, wenn Gemini am Limit ist.
Bekannte Besonderheiten von Gemini
| Anbieter | Bekanntes Problem | Was zu tun ist |
|---|---|---|
| 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. |
Live-Daten aus dem FreeLLMAPI-Katalog (Version 2026.11.19, geprüft 2026-11-19). Kostenlose Limits ändern sich oft. Der Katalog wird jeden Tag geprüft.
Häufig gestellte Fragen
Was bedeutet 429 RESOURCE_EXHAUSTED in der Gemini API?
Es bedeutet, dass Ihr Projekt ein Rate Limit oder ein Kontingent überschritten hat. Die quotaId im Fehlerinhalt zeigt, ob es sich um ein Limit pro Minute oder um ein tägliches Kontingent handelt.
Wann wird das Kontingent des kostenlosen Gemini-Tarifs zurückgesetzt?
Anfragen pro Tag werden um Mitternacht pazifischer Zeit zurückgesetzt. Limits pro Minute setzen sich innerhalb einer Minute zurück.
Warum behebt ein neuer Gemini-API-Schlüssel den Kontingentfehler nicht?
Google wendet Limits auf das Google-Cloud-Projekt an, nicht auf den Schlüssel. Jeder Schlüssel im selben Projekt teilt sich dasselbe Kontingent.
Was bedeutet limit: 0 in einem Gemini-Kontingentfehler?
Es bedeutet, dass Ihr Projekt in diesem Zeitfenster kein kostenloses Kontingent für dieses Modell hat. Manche Projekte sind für den kostenlosen Tarif nicht berechtigt. Prüfen Sie Ihre Limits in AI Studio oder versuchen Sie ein anderes Modell.
Wie vermeide ich Gemini-Fehler 429 in einem Coding-Agenten?
Verwenden Sie mehrere kostenlose Anbieter hinter einem Gateway. Erreicht Gemini sein Limit, sendet das Gateway die Anfrage an einen anderen Anbieter, sodass der Agent weiterarbeitet.
Verwandte Anleitungen
- Rate-Limits kostenloser LLM-APIs
- free gemini api
- Gemini CLI mit eigenem Endpunkt und kostenlosen Modellen
- Groq-Ratenlimit erreicht (429)
- NVIDIA NIM API Rate-Limit
Quellen
- Google AI Studio: Rate limits (geprüft 20 November 2026)
- Google AI Studio: API errors (geprüft 20 November 2026)
- Google AI Studio: Troubleshooting (geprüft 20 November 2026)
- Google developer forum: free tier quota error example (geprüft 20 November 2026)
- FreeLLMAPI docs: Quota and cooldown engine (geprüft 20 November 2026)
- FreeLLMAPI docs: Response headers (geprüft 20 November 2026)