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.PerDaygünlük kotadır.PerMinutekimliğ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:
| Kod | HTTP | Anlamı | Çözüm |
|---|---|---|---|
rate_limit_exceeded | 429 | Dakika veya saniye başına istek ya da jeton limitine ulaşıldı | Artan bekleme süreleriyle yeniden deneyin |
quota_exceeded | 429 | Günlük kota tükendi | Sıfırlanmasını bekleyin veya artış isteyin |
too_many_requests | 429 | Kısa bir pencerede çok fazla istek | Artan bekleme süreleriyle yeniden deneyin |
permission_denied | 403 | Proje kısıtlı veya bu proje için ücretsiz katman kullanılamıyor | Bir 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.
| Model | Ücretsiz olduğu yer | Bağlam | Ücretsiz limitler (en iyi teklif) | Araçlar | Görsel girdi |
|---|---|---|---|---|---|
| Gemini 3.8 Flash | Google AI Studio | 1M | Recurring provider quota | Evet | Evet |
| Gemini Flash (latest alias) | Google AI Studio | - | 10 istek/dk 20 istek/gün 250,000 jeton/dk ~3M | Evet | Evet |
| Gemini 3.7 Flash | Google AI Studio | 1M | 10 istek/dk 20 istek/gün 250,000 jeton/dk ~3M | Evet | Evet |
| Gemini 3.6 Flash | Google AI Studio | 1M | 10 istek/dk 20 istek/gün 250,000 jeton/dk ~3M | Evet | Evet |
| Gemini 3.5 Flash | Google AI Studio | 1M | 10 istek/dk 20 istek/gün 250,000 jeton/dk ~3M | Evet | Evet |
| Gemini 3.8 Live | Google AI Studio | - | 10 istek/dk 20 istek/gün 250,000 jeton/dk ~3M | Evet | Evet |
| Gemini 3.8 Live Extended Thinking | Google AI Studio | - | 10 istek/dk 20 istek/gün 250,000 jeton/dk ~3M | Evet | Evet |
| Gemini 3.8 Flash TTS | Google AI Studio | - | Ongoing AI Studio free-tier quota; account limits apply | Hayır | Hayır |
| Gemini 3.8 Flash-Lite TTS | Google AI Studio | - | Ongoing AI Studio free-tier quota; account limits apply | Hayır | Hayır |
| Gemini Robotics-ER 2 Preview | Google AI Studio | 131K | 10 istek/dk 20 istek/gün 250,000 jeton/dk ~3M | Hayır | Evet |
| Gemini 3.5 Flash Lite | Google AI Studio | 1M | 15 istek/dk 20 istek/gün 250,000 jeton/dk ~3M | Evet | Evet |
| Gemini Flash Lite (latest alias) | Google AI Studio | - | 10 istek/dk 20 istek/gün 250,000 jeton/dk ~3M | Evet | Evet |
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
quotaIddeğerini okuyun. İçindePerDayvarsa durun ve Pasifik saatiyle gece yarısı sıfırlanmayı bekleyin.- Dakikalık bir limitte artan bekleme süreleri ve rastgele gecikmeyle yeniden deneyin. En fazla yeniden deneme sayısını belirleyin.
- 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.
- Daha az jeton gönderin. Büyük istemler dakikadaki jeton limitine hızla ulaşır.
- Çok küçük bir
max_tokenskullanmayın. Gemini Flash, çıktı üst sınırının içinde gizli düşünme jetonları kullanabilir.
| Denediğiniz şey | Yardımcı olur mu? | Neden |
|---|---|---|
| Aynı projede yeni bir API anahtarı oluşturun | Hayır | Limitler projeye uygulanır. Google, yeni bir anahtarın hatayı çözmediğini söylüyor. |
| Projeyi ücretli katmana yükseltin | Ücretli kota verir | Google, ücretli katmanın size ücretsiz katman kotası vermediğini söyler. Ücretli kullanım faturalandırılır. |
retry in süresini bekleyin | Evet, dakikalık limitler için | Dakikalık pencere yenilenir |
| Farklı bir modele geçin | Evet | Her 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-Trailbaşlığı başarısız olan her adımı listeler, örneğingoogle/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 sorun | Ne yapmalı |
|---|---|---|
| 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. |
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.
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
- Ücretsiz LLM API hız sınırları
- free gemini api
- Özel uç noktalı Gemini CLI ve ücretsiz modeller
- Groq hız limitine ulaşıldı (429)
- NVIDIA NIM API hız sınırı
Kaynaklar
- Google AI Studio: Rate limits (20 November 2026 tarihinde kontrol edildi)
- Google AI Studio: API errors (20 November 2026 tarihinde kontrol edildi)
- Google AI Studio: Troubleshooting (20 November 2026 tarihinde kontrol edildi)
- Google developer forum: free tier quota error example (20 November 2026 tarihinde kontrol edildi)
- FreeLLMAPI docs: Quota and cooldown engine (20 November 2026 tarihinde kontrol edildi)
- FreeLLMAPI docs: Response headers (20 November 2026 tarihinde kontrol edildi)