Ana sayfa / Rehberler / Gemini API kotası aşıldı (429 RESOURCE_EXHAUSTED)

Gemini API kotası aşıldı (429 RESOURCE_EXHAUSTED)

Gemini API, bir hız limitini veya günlük kotayı aştığınızda 429 RESOURCE_EXHAUSTED döndürür. Ücretsiz katmanda limitler küçüktür. Bu sayfa hatanın her biçimini, geçerli ücretsiz limitleri ve işe yarayan çözümleri açıklar.

Kod, model adları ve canlı katalog etiketleri İngilizce gösterilir.

Hata nasıl görünür

Google'ın geliştirici forumunda paylaşılan tipik bir ücretsiz katman hatasının bölümleri şunlardır:

Ücretsiz katmandan örnek 429

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, neyin tükendiğini gösterir. generate_content_free_tier_requests, ücretsiz katmandaki istekleri sayar.
  • quotaId, pencereyi gösterir. PerDay günlük kotadır. PerMinute kimliği dakikalık limittir.
  • limit, o pencerede o modeldeki kotanızdır.
  • Please retry in, Google'ın önerdiği bekleme süresini verir.

Üç 429 kodu ve bir 403

Google'ın API hataları sayfası, HTTP 429 ile üç hata kodunu ve ilgili bir 403'ü listeler:

Gemini API hataları sayfasından
KodHTTPAnlamıÇözüm
rate_limit_exceeded429Dakika veya saniye başına istek ya da jeton limitine ulaşıldıArtan bekleme süreleriyle yeniden deneyin
quota_exceeded429Günlük kota tükendiSıfırlanmasını bekleyin veya artış isteyin
too_many_requests429Kısa bir pencerede çok fazla istekArtan bekleme süreleriyle yeniden deneyin
permission_denied403Proje kısıtlı veya bu proje için ücretsiz katman kullanılamıyorBir faturalandırma hesabı bağlayın ve ücretli katmanı kullanın

Dakikalık bir limit bir dakikadan kısa sürede temizlenir. Günlük kota ise yalnızca sıfırlanma zamanında temizlenir. Google, günlük istekleri Pasifik saatiyle gece yarısı sıfırlar. Günlük kota hatasını sıfırlanmadan önce yeniden denemek istekleri boşa harcar.

Bugünkü ücretsiz katman limitleri

Google limitleri API anahtarı başına değil, her Google Cloud projesi başına uygular. Limitler modele göre değişir. Google, etkin limitlerinizi AI Studio'da gösterir. Tablo, FreeLLMAPI kataloğundaki ücretsiz Gemini ve Gemma limitlerini gösterir.

Bugünkü katalogdan ücretsiz Gemini ve Gemma limitleri
ModelÜcretsiz olduğu yerBağlamÜcretsiz limitler (en iyi teklif)AraçlarGörsel girdi
Gemini 3.8 FlashGoogle AI Studio1MRecurring provider quotaEvetEvet
Gemini Flash (latest alias)Google AI Studio-10 istek/dk
20 istek/gün
250,000 jeton/dk
~3M
EvetEvet
Gemini 3.7 FlashGoogle AI Studio1M10 istek/dk
20 istek/gün
250,000 jeton/dk
~3M
EvetEvet
Gemini 3.6 FlashGoogle AI Studio1M10 istek/dk
20 istek/gün
250,000 jeton/dk
~3M
EvetEvet
Gemini 3.5 FlashGoogle AI Studio1M10 istek/dk
20 istek/gün
250,000 jeton/dk
~3M
EvetEvet
Gemini 3.8 LiveGoogle AI Studio-10 istek/dk
20 istek/gün
250,000 jeton/dk
~3M
EvetEvet
Gemini 3.8 Live Extended ThinkingGoogle AI Studio-10 istek/dk
20 istek/gün
250,000 jeton/dk
~3M
EvetEvet
Gemini 3.8 Flash TTSGoogle AI Studio-Ongoing AI Studio free-tier quota; account limits applyHayırHayır
Gemini 3.8 Flash-Lite TTSGoogle AI Studio-Ongoing AI Studio free-tier quota; account limits applyHayırHayır
Gemini Robotics-ER 2 PreviewGoogle AI Studio131K10 istek/dk
20 istek/gün
250,000 jeton/dk
~3M
HayırEvet
Gemini 3.5 Flash LiteGoogle AI Studio1M15 istek/dk
20 istek/gün
250,000 jeton/dk
~3M
EvetEvet
Gemini Flash Lite (latest alias)Google AI Studio-10 istek/dk
20 istek/gün
250,000 jeton/dk
~3M
EvetEvet

21 eşleşen ücretsiz modelden 12 tanesi gösteriliyor. Tüm modelleri gör.

Canlı veriler FreeLLMAPI kataloğundan alınır (sürüm 2026.11.19, 2026-11-19 tarihinde kontrol edildi). Ücretsiz limitler sık değişir. Katalog her gün kontrol edilir.

Çoğu Flash modeli ücretsiz katmanda günde yaklaşık 20 isteğe izin verir. Gemma modelleri günde çok daha fazla isteğe izin verir, ancak bağlam penceresi daha küçüktür. Google, belirtilen limitlerin garanti edilmediğini ve gerçek kapasitenin değişebileceğini söyler.

İşe yarayan çözümler

  1. quotaId değerini okuyun. İçinde PerDay varsa durun ve Pasifik saatiyle gece yarısı sıfırlanmayı bekleyin.
  2. Dakikalık bir limitte artan bekleme süreleri ve rastgele gecikmeyle yeniden deneyin. En fazla yeniden deneme sayısını belirleyin.
  3. Basit görevleri daha yüksek günlük üst sınırı olan bir modele taşıyın, örneğin bir Gemma veya Flash-Lite modeline.
  4. Daha az jeton gönderin. Büyük istemler dakikadaki jeton limitine hızla ulaşır.
  5. Çok küçük bir max_tokens kullanmayın. Gemini Flash, çıktı üst sınırının içinde gizli düşünme jetonları kullanabilir.
Denediğiniz şeyYardımcı olur mu?Neden
Aynı projede yeni bir API anahtarı oluşturunHayırLimitler projeye uygulanır. Google, yeni bir anahtarın hatayı çözmediğini söylüyor.
Projeyi ücretli katmana yükseltinÜcretli kota verirGoogle, ücretli katmanın size ücretsiz katman kotası vermediğini söyler. Ücretli kullanım faturalandırılır.
retry in süresini bekleyinEvet, dakikalık limitler içinDakikalık pencere yenilenir
Farklı bir modele geçinEvetHer modelin kendi kotası vardır

Göndermeden önce kotanızı kontrol edin

Hatayı görmeden önce sorunu fark edebilirsiniz. AI Studio'da, Gemini API belgelerindeki hız limiti sayfasını açın. Sayfa, her model için projenizin etkin limitlerini gösterir. Projects sayfası katmanınızı gösterir.

FreeLLMAPI kullanıyorsanız ağ geçidine hangi modellerin şimdi hazır olduğunu sorun. exhausted durumundaki bir modelin tüm anahtarları bekleme süresinde bekler. Bu durum, bekleme süreleri bittiğinde kendiliğinden temizlenir.

Şu anda yanıt verebilen modelleri listeleyin

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

Günlük kullanımınızı basit sayılarla planlayın. Günde 20 istekte bir Flash modeli, tam bir gün boyunca yaklaşık 72 dakikada bir istek verir. Bir kodlama ajanı tek bir görev için 20 isteği kullanabilir. Flash modellerini yalnızca zor görevlere ayırın ve basit görevleri daha büyük günlük üst sınırı olan modellere gönderin.

Diğer ücretsiz sağlayıcılara geçiş yapın

Günde yaklaşık 20 Flash isteğiyle, tek bir Gemini anahtarı ajan işleri için yeterli değildir. FreeLLMAPI, Gemini'yi diğer ücretsiz sağlayıcılarla birlikte tek bir uç nokta arkasına koyar. Gemini 429 gönderdiğinde yönlendirici isteği zincirinizdeki sonraki modele gönderir.

  • Yönlendirici her model ve anahtar için RPM, RPD, TPM ve TPD değerlerini sayar. Bilinen bir limite ulaşmadan durur.
  • Kısa bir 429, anahtarı 90 saniyelik bir bekleme süresine alır. Tam günlük kota ise daha uzun bir bekleme süresi kullanır: 2 dakika, 10 dakika, 1 saat, sonra 24 saat.
  • Google daha uzun bir yeniden deneme süresi verirse yönlendirici Google'ın değerini kullanır.
  • X-Fallback-Trail başlığı başarısız olan her adımı listeler, örneğin google/gemini-2.5-flash key1=rate_limited.

Gemini trafiğini ağ geçidi üzerinden gönderin

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, ağ geçidinin yerel /v1beta yüzeyini de kullanabilir. Ağ geçidi Gemini kotası eklemez. Gemini limitindeyken diğer sağlayıcıları kullanır.

Bilinen Gemini tuhaflıkları

SağlayıcıBilinen sorunNe yapmalı
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.

Canlı veriler FreeLLMAPI kataloğundan alınır (sürüm 2026.11.19, 2026-11-19 tarihinde kontrol edildi). Ücretsiz limitler sık değişir. Katalog her gün kontrol edilir.

Bunların hepsini tek bir anahtarla kullanın. FreeLLMAPI, açık kaynaklı ve kendi sunucunuzda çalışan bir yönlendiricidir. Tüm bu ücretsiz katmanları tek bir OpenAI uyumlu uç noktanın arkasında toplar ve bir sağlayıcı hız limitine takıldığında otomatik olarak başka birine geçer. Kataloğa göz atın veya canlı olarak incele.

Sık sorulan sorular

Gemini API'de 429 RESOURCE_EXHAUSTED ne anlama gelir?

Projenizin bir hız limitini veya kotasını aştığı anlamına gelir. Hata gövdesindeki quotaId, bunun dakikalık bir limit mi yoksa günlük kota mı olduğunu gösterir.

Gemini ücretsiz katman kotası ne zaman sıfırlanır?

Günlük istekler Pasifik saatiyle gece yarısı sıfırlanır. Dakikalık limitler bir dakika içinde sıfırlanır.

Neden yeni bir Gemini API anahtarı kota hatasını düzeltmiyor?

Google limitleri anahtara değil, Google Cloud projesine uygular. Aynı projedeki her anahtar aynı kotayı paylaşır.

Gemini kota hatasında limit: 0 ne anlama gelir?

Projenizin o pencerede o model için ücretsiz kotası olmadığı anlamına gelir. Bazı projeler ücretsiz katmana uygun değildir. Limitlerinizi AI Studio'da kontrol edin veya farklı bir model deneyin.

Bir kodlama ajanında Gemini 429 hatalarından nasıl kaçınırım?

Tek bir ağ geçidinin arkasında birkaç ücretsiz sağlayıcı kullanın. Gemini limitine ulaştığında ağ geçidi isteği başka bir sağlayıcıya gönderir, böylece ajan çalışmaya devam eder.

İlgili rehberler

Kaynaklar

Tüm rehberler · Tüm ücretsiz modelleri incele