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.quotaMetricmówi, co się wyczerpało.generate_content_free_tier_requestsliczy żądania w darmowym planie.quotaIdmówi, o jakie okno chodzi.PerDayto dzienny limit. IdentyfikatorPerMinuteto limit na minutę.limitto Twój limit dla tego modelu w tym oknie.Please retry inpodaje 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:
| Kod | HTTP | Znaczenie | Rozwiązanie |
|---|---|---|---|
rate_limit_exceeded | 429 | Osiągnięto limit żądań lub tokenów na minutę albo na sekundę | Ponów z rosnącym czasem oczekiwania |
quota_exceeded | 429 | Wykorzystano dzienny limit | Poczekaj na reset albo poproś o zwiększenie limitu |
too_many_requests | 429 | Zbyt wiele żądań w krótkim oknie | Ponów z rosnącym czasem oczekiwania |
permission_denied | 403 | Projekt jest ograniczony albo darmowy plan jest dla niego niedostępny | Podłą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.
| Model | Za darmo w | Kontekst | Darmowe limity (najlepsza oferta) | Narzędzia | Wizja |
|---|---|---|---|---|---|
| Gemini 3.8 Flash | Google AI Studio | 1M | Recurring provider quota | Tak | Tak |
| Gemini Flash (latest alias) | Google AI Studio | - | 10 żądań/min 20 żądań/dzień 250,000 tokenów/min ~3M | Tak | Tak |
| Gemini 3.7 Flash | Google AI Studio | 1M | 10 żądań/min 20 żądań/dzień 250,000 tokenów/min ~3M | Tak | Tak |
| Gemini 3.6 Flash | Google AI Studio | 1M | 10 żądań/min 20 żądań/dzień 250,000 tokenów/min ~3M | Tak | Tak |
| Gemini 3.5 Flash | Google AI Studio | 1M | 10 żądań/min 20 żądań/dzień 250,000 tokenów/min ~3M | Tak | Tak |
| Gemini 3.8 Live | Google AI Studio | - | 10 żądań/min 20 żądań/dzień 250,000 tokenów/min ~3M | Tak | Tak |
| Gemini 3.8 Live Extended Thinking | Google AI Studio | - | 10 żądań/min 20 żądań/dzień 250,000 tokenów/min ~3M | Tak | Tak |
| Gemini 3.8 Flash TTS | Google AI Studio | - | Ongoing AI Studio free-tier quota; account limits apply | Nie | Nie |
| Gemini 3.8 Flash-Lite TTS | Google AI Studio | - | Ongoing AI Studio free-tier quota; account limits apply | Nie | Nie |
| Gemini Robotics-ER 2 Preview | Google AI Studio | 131K | 10 żądań/min 20 żądań/dzień 250,000 tokenów/min ~3M | Nie | Tak |
| Gemini 3.5 Flash Lite | Google AI Studio | 1M | 15 żądań/min 20 żądań/dzień 250,000 tokenów/min ~3M | Tak | Tak |
| Gemini Flash Lite (latest alias) | Google AI Studio | - | 10 żądań/min 20 żądań/dzień 250,000 tokenów/min ~3M | Tak | Tak |
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ą
- Odczytaj
quotaId. Jeśli zawieraPerDay, zatrzymaj się i czekaj na reset o północy czasu Pacyfiku. - Przy limicie na minutę ponów z rosnącym czasem oczekiwania i losowym rozrzutem. Ustaw maksymalną liczbę ponowień.
- Przenieś proste zadania do modelu z wyższym dziennym limitem, na przykład modelu Gemma albo Flash-Lite.
- Wysyłaj mniej tokenów. Duże prompty szybko osiągają limit tokenów na minutę.
- Nie ustawiaj bardzo małego
max_tokens. Gemini Flash może zużywać ukryte tokeny rozumowania w ramach limitu wyjścia.
| Co próbujesz | Czy to pomaga? | Dlaczego |
|---|---|---|
| Utwórz nowy klucz API w tym samym projekcie | Nie | Limity dotyczą projektu. Google podaje, że nowy klucz nie usuwa błędu. |
| Przenieś projekt na płatny plan | Daje płatny limit | Google podaje, że płatny plan nie daje darmowego limitu. Użycie płatnego planu jest rozliczane. |
Poczekaj czas z retry in | Tak, przy limitach na minutę | Okno minutowe się odnawia |
| Zmień na inny model | Tak | Każ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-Trailwymienia każdy nieudany krok, na przykładgoogle/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
| Dostawca | Znany problem | Co zrobić |
|---|---|---|
| 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. |
Dane na żywo z katalogu FreeLLMAPI (wersja 2026.11.19, sprawdzono 2026-11-19). Darmowe limity często się zmieniają. Katalog jest sprawdzany codziennie.
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
- Darmowe API LLM: limity żądań
- free gemini api
- Gemini CLI z własnym punktem końcowym i darmowymi modelami
- Limit Groq przekroczony (429)
- Limit żądań NVIDIA NIM API
Źródła
- Google AI Studio: Rate limits (sprawdzono 20 November 2026)
- Google AI Studio: API errors (sprawdzono 20 November 2026)
- Google AI Studio: Troubleshooting (sprawdzono 20 November 2026)
- Google developer forum: free tier quota error example (sprawdzono 20 November 2026)
- FreeLLMAPI docs: Quota and cooldown engine (sprawdzono 20 November 2026)
- FreeLLMAPI docs: Response headers (sprawdzono 20 November 2026)