Cotă Gemini API depășită (429 RESOURCE_EXHAUSTED)
Gemini API returnează 429 RESOURCE_EXHAUSTED când depășiți o limită de rată sau o cotă zilnică. La nivelul gratuit, limitele sunt mici. Această pagină explică fiecare formă a erorii, limitele gratuite actuale și remedierile care funcționează.
Codul, numele modelelor și etichetele live din catalog sunt afișate în engleză.
Cum arată eroarea
O eroare tipică de la nivelul gratuit, publicată pe forumul pentru dezvoltatori Google, are aceste părți:
Exemplu de 429 de la nivelul gratuit
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.quotaMetricvă spune ce s-a epuizat.generate_content_free_tier_requestsnumără cererile de la nivelul gratuit.quotaIdvă spune fereastra.PerDayeste cota zilnică. Un IDPerMinuteeste limita pe minut.limiteste cota dumneavoastră pentru acel model în acea fereastră.Please retry indă timpul de așteptare pe care îl sugerează Google.
Cele trei coduri 429 și un 403
Pagina Google cu erorile API listează trei coduri de eroare cu HTTP 429 și un 403 înrudit:
| Cod | HTTP | Înțeles | Soluție |
|---|---|---|---|
rate_limit_exceeded | 429 | Limita de cereri sau tokeni pe minut sau pe secundă a fost atinsă | Reîncercați cu backoff exponențial |
quota_exceeded | 429 | Cota zilnică a fost epuizată | Așteptați resetarea sau cereți o creștere |
too_many_requests | 429 | Prea multe cereri într-o fereastră scurtă | Reîncercați cu backoff exponențial |
permission_denied | 403 | Proiectul este restricționat, sau nivelul gratuit nu este disponibil pentru el | Atașați un cont de facturare și folosiți nivelul plătit |
O limită pe minut se resetează în mai puțin de un minut. O cotă zilnică se resetează doar la reset. Google resetează cererile pe zi la miezul nopții, ora Pacificului. Reîncercarea unei erori de cotă zilnice înainte de reset consumă inutil cereri.
Limitele nivelului gratuit astăzi
Google aplică limitele pe fiecare proiect Google Cloud, nu pe fiecare cheie. Limitele diferă pentru fiecare model. Google afișează limitele active în AI Studio. Tabelul arată limitele gratuite Gemini și Gemma din catalogul FreeLLMAPI.
| Model | Gratuit pe | Context | Limite gratuite (cea mai bună ofertă) | Instrumente | Viziune |
|---|---|---|---|---|---|
| Gemini 3.8 Flash | Google AI Studio | 1M | Recurring provider quota | Da | Da |
| Gemini Flash (latest alias) | Google AI Studio | - | 10 cereri/min 20 cereri/zi 250,000 tokeni/min ~3M | Da | Da |
| Gemini 3.7 Flash | Google AI Studio | 1M | 10 cereri/min 20 cereri/zi 250,000 tokeni/min ~3M | Da | Da |
| Gemini 3.6 Flash | Google AI Studio | 1M | 10 cereri/min 20 cereri/zi 250,000 tokeni/min ~3M | Da | Da |
| Gemini 3.5 Flash | Google AI Studio | 1M | 10 cereri/min 20 cereri/zi 250,000 tokeni/min ~3M | Da | Da |
| Gemini 3.8 Live | Google AI Studio | - | 10 cereri/min 20 cereri/zi 250,000 tokeni/min ~3M | Da | Da |
| Gemini 3.8 Live Extended Thinking | Google AI Studio | - | 10 cereri/min 20 cereri/zi 250,000 tokeni/min ~3M | Da | Da |
| Gemini 3.8 Flash TTS | Google AI Studio | - | Ongoing AI Studio free-tier quota; account limits apply | Nu | Nu |
| Gemini 3.8 Flash-Lite TTS | Google AI Studio | - | Ongoing AI Studio free-tier quota; account limits apply | Nu | Nu |
| Gemini Robotics-ER 2 Preview | Google AI Studio | 131K | 10 cereri/min 20 cereri/zi 250,000 tokeni/min ~3M | Nu | Da |
| Gemini 3.5 Flash Lite | Google AI Studio | 1M | 15 cereri/min 20 cereri/zi 250,000 tokeni/min ~3M | Da | Da |
| Gemini Flash Lite (latest alias) | Google AI Studio | - | 10 cereri/min 20 cereri/zi 250,000 tokeni/min ~3M | Da | Da |
Se afișează 12 din 21 modele gratuite care se potrivesc. Vezi toate modelele.
Date live din catalogul FreeLLMAPI (versiunea 2026.11.19, verificat 2026-11-19). Limitele gratuite se schimbă des. Catalogul este verificat în fiecare zi.
Majoritatea modelelor Flash permit aproximativ 20 de cereri pe zi la nivelul gratuit. Modelele Gemma permit mult mai multe cereri pe zi, dar au o fereastră de context mai mică. Google spune că limitele specificate nu sunt garantate și că capacitatea reală poate varia.
Remedieri care funcționează
- Citiți
quotaId. Dacă conținePerDay, opriți-vă și așteptați resetarea de la miezul nopții, ora Pacificului. - Pentru o limită pe minut, reîncercați cu backoff exponențial și jitter. Setați un număr maxim de reîncercări.
- Mutați sarcinile simple pe un model cu plafon zilnic mai mare, de exemplu un model Gemma sau Flash-Lite.
- Trimiteți mai puțini tokeni. Prompturile mari ating limita de tokeni pe minut rapid.
- Nu folosiți un
max_tokensfoarte mic. Gemini Flash poate folosi tokeni de raționament ascunși în interiorul plafonului de ieșire.
| Ce încercați | Ajută? | De ce |
|---|---|---|
| Creați o cheie API nouă în același proiect | Nu | Limitele se aplică proiectului. Google spune că o cheie nouă nu rezolvă eroarea. |
| Treceți proiectul la nivelul plătit | Oferă cotă plătită | Google spune că nivelul plătit nu vă dă cotă de nivel gratuit. Utilizarea plătită se facturează. |
Așteptați timpul retry in | Da, pentru limitele pe minut | Fereastra de minut se reînnoiește |
| Treceți la un alt model | Da | Fiecare model are propria cotă |
Verificați cota înainte să trimiteți
Problema se poate vedea înainte de eroare. În AI Studio, deschideți pagina de limite de rată din documentația Gemini API. Ea arată limitele active ale proiectului dumneavoastră pentru fiecare model. Pagina Projects arată nivelul dumneavoastră.
Dacă folosiți FreeLLMAPI, întrebați gateway-ul ce modele sunt gata acum. Un model cu starea exhausted are chei care sunt toate în perioadă de pauză. Starea dispare singură când se termină perioadele de pauză.
Listați modelele care pot răspunde acum
curl "http://localhost:3001/v1/models?execution_status=ready" \
-H "Authorization: Bearer <unified-key>"Planificați utilizarea zilnică cu numere simple. La 20 de cereri pe zi, un model Flash vă dă aproximativ o cerere la fiecare 72 de minute, pe toată ziua. Un agent de programare poate folosi 20 de cereri pentru o singură sarcină. Folosiți modelele Flash doar pentru sarcini grele și trimiteți sarcinile simple către modele cu plafoane zilnice mai mari.
Treceți la alți furnizori gratuiți
Cu aproximativ 20 de cereri Flash pe zi, o singură cheie Gemini nu ajunge pentru lucru cu agenți. FreeLLMAPI pune Gemini în spatele unui singur endpoint, împreună cu alți furnizori gratuiți. Când Gemini trimite un 429, routerul trimite cererea la următorul model din lanțul dumneavoastră.
- Routerul numără RPM, RPD, TPM și TPD pentru fiecare model și cheie. Se oprește înainte să ajungă la o limită cunoscută.
- Un 429 scurt pune cheia în perioadă de pauză de 90 de secunde. O cotă zilnică epuizată folosește o pauză mai lungă: 2 minute, 10 minute, 1 oră, apoi 24 de ore.
- Dacă Google dă un timp de reîncercare mai lung, routerul folosește valoarea Google.
- Antetul
X-Fallback-Traillistează fiecare salt eșuat, de exemplugoogle/gemini-2.5-flash key1=rate_limited.
Trimiteți traficul Gemini prin gateway
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 poate folosi și suprafața nativă /v1beta a gateway-ului. Gateway-ul nu adaugă cotă Gemini. Folosește alți furnizori când Gemini este la limită.
Particularități cunoscute ale Gemini
| Furnizor | Problemă cunoscută | Ce trebuie făcut |
|---|---|---|
| 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. |
Date live din catalogul FreeLLMAPI (versiunea 2026.11.19, verificat 2026-11-19). Limitele gratuite se schimbă des. Catalogul este verificat în fiecare zi.
Întrebări frecvente
Ce înseamnă 429 RESOURCE_EXHAUSTED în Gemini API?
Înseamnă că proiectul dumneavoastră a depășit o limită de rată sau o cotă. quotaId din corpul erorii vă spune dacă este o limită pe minut sau o cotă zilnică.
Când se resetează cota nivelului gratuit Gemini?
Cererile pe zi se resetează la miezul nopții, ora Pacificului. Limitele pe minut se resetează în cel mult un minut.
De ce o cheie Gemini API nouă nu rezolvă eroarea de cotă?
Google aplică limitele proiectului Google Cloud, nu cheii. Fiecare cheie din același proiect împarte aceeași cotă.
Ce înseamnă limit: 0 într-o eroare de cotă Gemini?
Înseamnă că proiectul dumneavoastră nu are cotă gratuită pentru acel model în acea fereastră. Unele proiecte nu sunt eligibile pentru nivelul gratuit. Verificați limitele în AI Studio sau încercați un alt model.
Cum evit erorile Gemini 429 într-un agent de programare?
Folosiți mai mulți furnizori gratuiți în spatele unui singur gateway. Când Gemini ajunge la limită, gateway-ul trimite cererea la alt furnizor, astfel încât agentul continuă.
Ghiduri înrudite
- Limite de rată pentru Free LLM API
- free gemini api
- Gemini CLI cu endpoint personalizat și modele gratuite
- Limita de rată Groq atinsă (429)
- Limita de rată NVIDIA NIM API
Surse
- Google AI Studio: Rate limits (verificat 20 November 2026)
- Google AI Studio: API errors (verificat 20 November 2026)
- Google AI Studio: Troubleshooting (verificat 20 November 2026)
- Google developer forum: free tier quota error example (verificat 20 November 2026)
- FreeLLMAPI docs: Quota and cooldown engine (verificat 20 November 2026)
- FreeLLMAPI docs: Response headers (verificat 20 November 2026)