Startseite / Anleitungen / Gemini-API-Kontingent überschritten (429 RESOURCE_EXHAUSTED)

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.
  • quotaMetric zeigt Ihnen, was aufgebraucht ist. generate_content_free_tier_requests zählt Anfragen im kostenlosen Tarif.
  • quotaId zeigt Ihnen das Zeitfenster. PerDay ist das tägliche Kontingent. Eine ID PerMinute ist das Limit pro Minute.
  • limit ist Ihr Kontingent für dieses Modell in diesem Zeitfenster.
  • Please retry in gibt 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:

Von der Seite mit den Fehlern der Gemini API
CodeHTTPBedeutungLösung
rate_limit_exceeded429Limit pro Minute oder pro Sekunde für Anfragen oder Token erreichtMit exponentiellem Backoff erneut versuchen
quota_exceeded429Tägliches Kontingent aufgebrauchtBis zum Zurücksetzen warten oder eine Erhöhung anfordern
too_many_requests429Zu viele Anfragen in kurzer ZeitMit exponentiellem Backoff erneut versuchen
permission_denied403Das Projekt ist eingeschränkt, oder der kostenlose Tarif ist dafür nicht verfügbarEin 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.

Kostenlose Limits für Gemini und Gemma aus dem heutigen Katalog
ModellKostenlos beiKontextKostenlose Limits (bestes Angebot)ToolsBildverarbeitung
Gemini 3.8 FlashGoogle AI Studio1MRecurring provider quotaJaJa
Gemini Flash (latest alias)Google AI Studio-10 Anfragen/Min.
20 Anfragen/Tag
250,000 Token/Min.
~3M
JaJa
Gemini 3.7 FlashGoogle AI Studio1M10 Anfragen/Min.
20 Anfragen/Tag
250,000 Token/Min.
~3M
JaJa
Gemini 3.6 FlashGoogle AI Studio1M10 Anfragen/Min.
20 Anfragen/Tag
250,000 Token/Min.
~3M
JaJa
Gemini 3.5 FlashGoogle AI Studio1M10 Anfragen/Min.
20 Anfragen/Tag
250,000 Token/Min.
~3M
JaJa
Gemini 3.8 LiveGoogle AI Studio-10 Anfragen/Min.
20 Anfragen/Tag
250,000 Token/Min.
~3M
JaJa
Gemini 3.8 Live Extended ThinkingGoogle AI Studio-10 Anfragen/Min.
20 Anfragen/Tag
250,000 Token/Min.
~3M
JaJa
Gemini 3.8 Flash TTSGoogle AI Studio-Ongoing AI Studio free-tier quota; account limits applyNeinNein
Gemini 3.8 Flash-Lite TTSGoogle AI Studio-Ongoing AI Studio free-tier quota; account limits applyNeinNein
Gemini Robotics-ER 2 PreviewGoogle AI Studio131K10 Anfragen/Min.
20 Anfragen/Tag
250,000 Token/Min.
~3M
NeinJa
Gemini 3.5 Flash LiteGoogle AI Studio1M15 Anfragen/Min.
20 Anfragen/Tag
250,000 Token/Min.
~3M
JaJa
Gemini Flash Lite (latest alias)Google AI Studio-10 Anfragen/Min.
20 Anfragen/Tag
250,000 Token/Min.
~3M
JaJa

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

  1. Lesen Sie die quotaId. Enthält sie PerDay, stoppen Sie und warten Sie bis zum Zurücksetzen um Mitternacht pazifischer Zeit.
  2. Bei einem Limit pro Minute wiederholen Sie die Anfrage mit exponentiellem Backoff und Jitter. Legen Sie eine maximale Anzahl an Wiederholungen fest.
  3. Verlagern Sie einfache Aufgaben auf ein Modell mit höherer Tagesobergrenze, zum Beispiel ein Gemma- oder Flash-Lite-Modell.
  4. Senden Sie weniger Token. Große Prompts erreichen das Limit pro Minute für Token schnell.
  5. Verwenden Sie kein sehr kleines max_tokens. Gemini Flash kann versteckte Denk-Token innerhalb der Ausgabegrenze verbrauchen.
Was Sie versuchenHilft es?Warum
Einen neuen API-Schlüssel im selben Projekt erstellenNeinLimits gelten für das Projekt. Google sagt, dass ein neuer Schlüssel den Fehler nicht behebt.
Das Projekt auf den kostenpflichtigen Tarif umstellenGibt kostenpflichtiges KontingentGoogle sagt, dass der kostenpflichtige Tarif Ihnen kein Kontingent des kostenlosen Tarifs gibt. Kostenpflichtige Nutzung wird abgerechnet.
Die Zeit retry in abwartenJa, bei Limits pro MinuteDas Zeitfenster pro Minute wird zurückgesetzt
Auf ein anderes Modell wechselnJaJedes 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-Trail listet jeden fehlgeschlagenen Schritt auf, zum Beispiel google/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

AnbieterBekanntes ProblemWas zu tun ist
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.

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.

Nutzen Sie alle diese Modelle über einen einzigen Schlüssel. FreeLLMAPI ist ein Open-Source-Router, den Sie selbst hosten. Er stellt alle diese kostenlosen Angebote hinter einem einzigen OpenAI-kompatiblen Endpunkt bereit und wechselt zum nächsten Anbieter, wenn ein Anbieter das Limit erreicht. Katalog ansehen oder Jetzt starten.

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

Quellen

Alle Anleitungen · Alle kostenlosen Modelle ansehen