Acasă / Ghiduri / Cotă Gemini API depășită (429 RESOURCE_EXHAUSTED)

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.
  • quotaMetric vă spune ce s-a epuizat. generate_content_free_tier_requests numără cererile de la nivelul gratuit.
  • quotaId vă spune fereastra. PerDay este cota zilnică. Un ID PerMinute este limita pe minut.
  • limit este cota dumneavoastră pentru acel model în acea fereastră.
  • Please retry in dă 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:

Din pagina Gemini API errors
CodHTTPÎnțelesSoluție
rate_limit_exceeded429Limita de cereri sau tokeni pe minut sau pe secundă a fost atinsăReîncercați cu backoff exponențial
quota_exceeded429Cota zilnică a fost epuizatăAșteptați resetarea sau cereți o creștere
too_many_requests429Prea multe cereri într-o fereastră scurtăReîncercați cu backoff exponențial
permission_denied403Proiectul este restricționat, sau nivelul gratuit nu este disponibil pentru elAtaș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.

Limite gratuite Gemini și Gemma din catalogul de astăzi
ModelGratuit peContextLimite gratuite (cea mai bună ofertă)InstrumenteViziune
Gemini 3.8 FlashGoogle AI Studio1MRecurring provider quotaDaDa
Gemini Flash (latest alias)Google AI Studio-10 cereri/min
20 cereri/zi
250,000 tokeni/min
~3M
DaDa
Gemini 3.7 FlashGoogle AI Studio1M10 cereri/min
20 cereri/zi
250,000 tokeni/min
~3M
DaDa
Gemini 3.6 FlashGoogle AI Studio1M10 cereri/min
20 cereri/zi
250,000 tokeni/min
~3M
DaDa
Gemini 3.5 FlashGoogle AI Studio1M10 cereri/min
20 cereri/zi
250,000 tokeni/min
~3M
DaDa
Gemini 3.8 LiveGoogle AI Studio-10 cereri/min
20 cereri/zi
250,000 tokeni/min
~3M
DaDa
Gemini 3.8 Live Extended ThinkingGoogle AI Studio-10 cereri/min
20 cereri/zi
250,000 tokeni/min
~3M
DaDa
Gemini 3.8 Flash TTSGoogle AI Studio-Ongoing AI Studio free-tier quota; account limits applyNuNu
Gemini 3.8 Flash-Lite TTSGoogle AI Studio-Ongoing AI Studio free-tier quota; account limits applyNuNu
Gemini Robotics-ER 2 PreviewGoogle AI Studio131K10 cereri/min
20 cereri/zi
250,000 tokeni/min
~3M
NuDa
Gemini 3.5 Flash LiteGoogle AI Studio1M15 cereri/min
20 cereri/zi
250,000 tokeni/min
~3M
DaDa
Gemini Flash Lite (latest alias)Google AI Studio-10 cereri/min
20 cereri/zi
250,000 tokeni/min
~3M
DaDa

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ă

  1. Citiți quotaId. Dacă conține PerDay, opriți-vă și așteptați resetarea de la miezul nopții, ora Pacificului.
  2. Pentru o limită pe minut, reîncercați cu backoff exponențial și jitter. Setați un număr maxim de reîncercări.
  3. Mutați sarcinile simple pe un model cu plafon zilnic mai mare, de exemplu un model Gemma sau Flash-Lite.
  4. Trimiteți mai puțini tokeni. Prompturile mari ating limita de tokeni pe minut rapid.
  5. Nu folosiți un max_tokens foarte mic. Gemini Flash poate folosi tokeni de raționament ascunși în interiorul plafonului de ieșire.
Ce încercațiAjută?De ce
Creați o cheie API nouă în același proiectNuLimitele se aplică proiectului. Google spune că o cheie nouă nu rezolvă eroarea.
Treceți proiectul la nivelul plătitOferă 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 inDa, pentru limitele pe minutFereastra de minut se reînnoiește
Treceți la un alt modelDaFiecare 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-Trail listează fiecare salt eșuat, de exemplu google/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

FurnizorProblemă cunoscutăCe trebuie făcut
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.

Date live din catalogul FreeLLMAPI (versiunea 2026.11.19, verificat 2026-11-19). Limitele gratuite se schimbă des. Catalogul este verificat în fiecare zi.

Folosiți fiecare dintre aceste modele printr-o singură cheie. FreeLLMAPI este un router open-source, găzduit de dumneavoastră, care pune toate aceste niveluri gratuite în spatele unui singur endpoint compatibil cu OpenAI și trece la alt furnizor când un furnizor este limitat la rată. Vezi catalogul sau trece live.

Î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

Surse

Toate ghidurile · Vezi toate modelele gratuite