Strona główna / Poradniki / Przekroczony limit Gemini API (429 RESOURCE_EXHAUSTED)

Przekroczony limit Gemini API (429 RESOURCE_EXHAUSTED)

Gemini API zwraca 429 RESOURCE_EXHAUSTED, gdy przekroczysz limit szybkości lub dzienny limit. W darmowym planie limity są małe. Ta strona wyjaśnia każdą postać błędu, aktualne darmowe limity i poprawki, które działają.

Kod, nazwy modeli i etykiety z katalogu na żywo są podane po angielsku.

Jak wygląda błąd

Typowy błąd darmowego planu, opublikowany na forum deweloperskim Google, ma te części:

Przykład 429 z darmowego planu

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 mówi, co się wyczerpało. generate_content_free_tier_requests liczy żądania w darmowym planie.
  • quotaId mówi, o jakie okno chodzi. PerDay to dzienny limit. Identyfikator PerMinute to limit na minutę.
  • limit to Twój limit dla tego modelu w tym oknie.
  • Please retry in podaje czas oczekiwania, który sugeruje Google.

Trzy kody 429 i jeden 403

Strona błędów API Google wymienia trzy kody błędów z HTTP 429 i powiązany kod 403:

Ze strony błędów Gemini API
KodHTTPZnaczenieRozwiązanie
rate_limit_exceeded429Osiągnięto limit żądań lub tokenów na minutę albo na sekundęPonów z rosnącym czasem oczekiwania
quota_exceeded429Wykorzystano dzienny limitPoczekaj na reset albo poproś o zwiększenie limitu
too_many_requests429Zbyt wiele żądań w krótkim okniePonów z rosnącym czasem oczekiwania
permission_denied403Projekt jest ograniczony albo darmowy plan jest dla niego niedostępnyPodłącz konto rozliczeniowe i użyj płatnego planu

Limit na minutę znika w czasie krótszym niż minuta. Dzienny limit znika dopiero przy resecie. Google resetuje żądania dzienne o północy czasu Pacyfiku. Ponawianie błędu dziennego limitu przed resetem marnuje żądania.

Darmowe limity planu dzisiaj

Google stosuje limity do każdego projektu Google Cloud, a nie do każdego klucza. Limity są różne dla każdego modelu. Google pokazuje aktywne limity w AI Studio. Tabela pokazuje darmowe limity Gemini i Gemma w katalogu FreeLLMAPI.

Darmowe limity Gemini i Gemma z dzisiejszego katalogu
ModelZa darmo wKontekstDarmowe limity (najlepsza oferta)NarzędziaWizja
Gemini 3.8 FlashGoogle AI Studio1MRecurring provider quotaTakTak
Gemini Flash (latest alias)Google AI Studio-10 żądań/min
20 żądań/dzień
250,000 tokenów/min
~3M
TakTak
Gemini 3.7 FlashGoogle AI Studio1M10 żądań/min
20 żądań/dzień
250,000 tokenów/min
~3M
TakTak
Gemini 3.6 FlashGoogle AI Studio1M10 żądań/min
20 żądań/dzień
250,000 tokenów/min
~3M
TakTak
Gemini 3.5 FlashGoogle AI Studio1M10 żądań/min
20 żądań/dzień
250,000 tokenów/min
~3M
TakTak
Gemini 3.8 LiveGoogle AI Studio-10 żądań/min
20 żądań/dzień
250,000 tokenów/min
~3M
TakTak
Gemini 3.8 Live Extended ThinkingGoogle AI Studio-10 żądań/min
20 żądań/dzień
250,000 tokenów/min
~3M
TakTak
Gemini 3.8 Flash TTSGoogle AI Studio-Ongoing AI Studio free-tier quota; account limits applyNieNie
Gemini 3.8 Flash-Lite TTSGoogle AI Studio-Ongoing AI Studio free-tier quota; account limits applyNieNie
Gemini Robotics-ER 2 PreviewGoogle AI Studio131K10 żądań/min
20 żądań/dzień
250,000 tokenów/min
~3M
NieTak
Gemini 3.5 Flash LiteGoogle AI Studio1M15 żądań/min
20 żądań/dzień
250,000 tokenów/min
~3M
TakTak
Gemini Flash Lite (latest alias)Google AI Studio-10 żądań/min
20 żądań/dzień
250,000 tokenów/min
~3M
TakTak

Pokazano 12 z 21 pasujących darmowych modeli. Zobacz wszystkie modele.

Dane na żywo z katalogu FreeLLMAPI (wersja 2026.11.19, sprawdzono 2026-11-19). Darmowe limity często się zmieniają. Katalog jest sprawdzany codziennie.

Większość modeli Flash dopuszcza około 20 żądań dziennie w darmowym planie. Modele Gemma dopuszczają dużo więcej żądań dziennie, ale mają mniejsze okno kontekstu. Google podaje, że podane limity nie są gwarantowane, a rzeczywista pojemność może się różnić.

Poprawki, które działają

  1. Odczytaj quotaId. Jeśli zawiera PerDay, zatrzymaj się i czekaj na reset o północy czasu Pacyfiku.
  2. Przy limicie na minutę ponów z rosnącym czasem oczekiwania i losowym rozrzutem. Ustaw maksymalną liczbę ponowień.
  3. Przenieś proste zadania do modelu z wyższym dziennym limitem, na przykład modelu Gemma albo Flash-Lite.
  4. Wysyłaj mniej tokenów. Duże prompty szybko osiągają limit tokenów na minutę.
  5. Nie ustawiaj bardzo małego max_tokens. Gemini Flash może zużywać ukryte tokeny rozumowania w ramach limitu wyjścia.
Co próbujeszCzy to pomaga?Dlaczego
Utwórz nowy klucz API w tym samym projekcieNieLimity dotyczą projektu. Google podaje, że nowy klucz nie usuwa błędu.
Przenieś projekt na płatny planDaje płatny limitGoogle podaje, że płatny plan nie daje darmowego limitu. Użycie płatnego planu jest rozliczane.
Poczekaj czas z retry inTak, przy limitach na minutęOkno minutowe się odnawia
Zmień na inny modelTakKażdy model ma własny limit

Sprawdź limit przed wysłaniem

Problem widać przed błędem. W AI Studio otwórz stronę limitów szybkości z dokumentacji Gemini API. Pokazuje aktywne limity Twojego projektu dla każdego modelu. Strona Projects pokazuje Twój plan.

Jeśli używasz FreeLLMAPI, zapytaj bramę, które modele są teraz gotowe. Model ze statusem exhausted ma klucze, które wszystkie czekają na przerwę. Ten status znika sam, gdy kończą się przerwy.

Lista modeli, które mogą odpowiedzieć teraz

curl "http://localhost:3001/v1/models?execution_status=ready" \
  -H "Authorization: Bearer <unified-key>"

Planuj dzienne użycie prostymi liczbami. Przy 20 żądaniach dziennie jeden model Flash daje około jedno żądanie co 72 minuty przez cały dzień. Agent do kodowania może zużyć 20 żądań na jedno zadanie. Używaj modeli Flash tylko do trudnych zadań, a proste wysyłaj do modeli z większym dziennym limitem.

Przełączanie na innych darmowych dostawców

Przy około 20 żądaniach Flash dziennie jeden klucz Gemini nie wystarcza do pracy agentowej. FreeLLMAPI umieszcza Gemini za jednym punktem końcowym razem z innymi darmowymi dostawcami. Gdy Gemini wyśle 429, router przekazuje żądanie do następnego modelu z łańcucha.

  • Router liczy RPM, RPD, TPM i TPD dla każdego modelu i klucza. Zatrzymuje się, zanim dojdzie do znanego limitu.
  • Krótki błąd 429 wstrzymuje klucz na 90 sekund. Wyczerpany dzienny limit daje dłuższą przerwę: 2 minuty, 10 minut, 1 godzinę, potem 24 godziny.
  • Jeśli Google poda dłuższy czas oczekiwania, router używa wartości Google.
  • Nagłówek X-Fallback-Trail wymienia każdy nieudany krok, na przykład google/gemini-2.5-flash key1=rate_limited.

Kieruj ruch Gemini przez bramę

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 może też używać natywnej powierzchni /v1beta bramy. Brama nie dodaje limitu Gemini. Gdy Gemini osiągnie limit, używa innych dostawców.

Znane osobliwości Gemini

DostawcaZnany problemCo zrobić
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.

Dane na żywo z katalogu FreeLLMAPI (wersja 2026.11.19, sprawdzono 2026-11-19). Darmowe limity często się zmieniają. Katalog jest sprawdzany codziennie.

Używaj wszystkich tych modeli przez jeden klucz. FreeLLMAPI to router o otwartym kodzie, uruchamiany na własnym serwerze. Łączy wszystkie te darmowe plany za jednym punktem końcowym zgodnym z OpenAI i przełącza się na inny dostawcę, gdy limit zostanie przekroczony. Przeglądaj katalog lub uruchom.

Najczęstsze pytania

Co oznacza 429 RESOURCE_EXHAUSTED w Gemini API?

Oznacza, że Twój projekt przekroczył limit szybkości lub limit. quotaId w treści błędu mówi, czy to limit na minutę, czy dzienny.

Kiedy resetuje się darmowy limit Gemini?

Żądania dzienne resetują się o północy czasu Pacyfiku. Limity na minutę resetują się w ciągu jednej minuty.

Dlaczego nowy klucz API Gemini nie usuwa błędu limitu?

Google stosuje limity do projektu Google Cloud, a nie do klucza. Każdy klucz w tym samym projekcie dzieli ten sam limit.

Co oznacza limit: 0 w błędzie limitu Gemini?

Oznacza, że Twój projekt nie ma darmowego limitu dla tego modelu w tym oknie. Niektóre projekty nie kwalifikują się do darmowego planu. Sprawdź limity w AI Studio albo wypróbuj inny model.

Jak uniknąć błędów 429 Gemini w agencie do kodowania?

Używaj kilku darmowych dostawców za jedną bramą. Gdy Gemini osiągnie limit, brama wysyła żądanie do innego dostawcy, więc agent działa dalej.

Powiązane poradniki

Źródła

Wszystkie poradniki · Przeglądaj wszystkie darmowe modele