Gemini API 429 RESOURCE_EXHAUSTED — Kontingent vs. Rate-Limit, richtig behoben

RESOURCE_EXHAUSTED ist Geminis Sammelfehler für 429. Wenn er nach einer Minute verschwindet, wurde ein Ratenlimit erreicht — Backoff behebt das. Hält er bis Mitternacht Pacific Time an, ist das tägliche Kontingent der kostenlosen Stufe erschöpft — keine Wiederholungsschleife kann das beheben; nur Abrechnung oder ein anderer Weg hilft.

Der Fehler

Antwort (HTTP 429)

{
  "error": {
    "code": 429,
    "message": "Resource has been exhausted (e.g. check quota).",
    "status": "RESOURCE_EXHAUSTED"
  }
}

Ursachen und Lösungen im Überblick

Ursache	Lösung
Ratenlimit pro Minute (RPM/TPM)	Backoff mit Jitter verwenden; Lastspitzen glätten. Wird innerhalb von ~60 s aufgehoben.
Tägliches Kontingent der kostenlosen Stufe erschöpft	Bis zur täglichen Zurücksetzung warten — Abrechnung aktivieren, Kontingent erhöhen oder über ein kostenpflichtiges Gateway routen.
Viele Worker teilen sich einen Schlüssel	Das Kontingent gilt pro Projekt, nicht pro Worker — zentralisieren Sie den Rate-Limiter oder verteilen Sie die Last auf mehrere Projekte/Schlüssel.

Einordnen: Minutenlimit oder Tageskontingent

Nach 60 Sekunden einmal wiederholen. Erfolg → Ratenlimit im Minutenbereich (Backoff hinzufügen und fortfahren). Weiterhin 429 → Tageskontingent; unter Cloud Console → Quotas prüfen, welcher genaue Zähler bei 100 % liegt.

Für Minutenlimits: der Standard-Backoff

Dasselbe Muster wie bei jedem 429 — exponentiell, mit Jitter, und nur bei wiederholbaren Statuscodes erneut versuchen. Verwenden Sie das Snippet aus unserem Claude-429-Leitfaden unverändert; es ist providerunabhängig.

Für Tageskontingente: die Wirtschaftlichkeit ändern

Kontingente der kostenlosen Stufe sind für Prototypen gedacht. Für den Produktionseinsatz muss die Abrechnung im Projekt aktiviert sein — oder Sie verwenden ein Pay-as-you-go-Gateway, bei dem Ihr Budget statt eines Tageszählers die Grenze bildet. Vergleichen Sie vor der Auswahl die Kosten pro Token.

Wenn Sie Kunavo verwenden

Bei Kunavo werden Gemini 2.5 Flash/Pro über ein gemeinsames Prepaid-Guthaben nach dem Pay-as-you-go-Modell abgerechnet — es gibt kein tägliches Kontingent der kostenlosen Stufe, das erschöpft werden kann, und fehlgeschlagene Anfragen werden nicht berechnet. Für Workloads, die ständig die Tageskontingente von AI Studio auslösen, ist der Tokenpreis (deutlich unter Googles Listenpreis) meist günstiger als die dafür aufgewendete Entwicklungszeit zum Aufteilen der Projekte.

Häufig gestellte Fragen

Wann wird das kostenlose Gemini-Kontingent zurückgesetzt?

Tägliche Kontingente werden um Mitternacht Pacific Time zurückgesetzt. Minutenlimits werden in einem rollierenden 60-Sekunden-Fenster zurückgesetzt.

Behebt Backoff RESOURCE_EXHAUSTED?

Nur bei der Variante pro Minute. Ein erschöpftes Tageskontingent liefert bis zur Zurücksetzung bei jeder Wiederholung 429 — erkennen Sie diesen Fall (429 bleibt nach einer Wartezeit von 60 s bestehen) und beenden Sie weitere Wiederholungen.