Gemini 503 “Model aşırı yüklendi” (UNAVAILABLE) — işe yarayan yeniden denemeler ve ne zaman durulacağı

“Model aşırı yüklendi”, sizinle ilgili olmayan tek Gemini hatasıdır: o modelin sunum havuzunda şu anda kapasite yoktur. Proje ayarlarınızda bunu önleyebilecek hiçbir şey yoktur — kontrol edebildiğiniz şey, durumu ne kadar zarif atlattığınız ve geçmediğinde hangi geri dönüşü seçtiğinizdir.

Hata

yanıt (HTTP 503)

{
  "error": {
    "code": 503,
    "message": "The model is overloaded. Please try again later.",
    "status": "UNAVAILABLE"
  }
}

Nedenler ve çözümler özeti

Neden	Çözüm
O modelin sunum havuzunda talep artışı	Jitter içeren üstel geri çekilme; ani yük artışı genellikle birkaç saniye ile birkaç dakika içinde geçer.
Önizleme / deneysel model varyantları	-exp ve preview derlemeleri küçük havuzlarda çalışır ve önce aşırı yüklenir. Üretimde kararlı takma adı sabitleyin.
Yoğun saatlerde ağır istekler	Büyük bağlamların ve maksimum çıktı sınırlarının yük altında elenme olasılığı daha yüksektir — ihtiyacınız olmayanları kısaltın, yanıtı akış olarak alın.

Bunun 429 değil 503 UNAVAILABLE olduğunu doğrulayın

429 RESOURCE_EXHAUSTED sizin kotanızdır; 503 UNAVAILABLE ise Google'ın kapasitesidir. Bu ayrım sonraki her şeyi belirler: kota hataları faturalandırma veya limit değişikliği, kapasite hataları ise yeniden deneme ve geri dönüş gerektirir. 503 için proje ayarlarınızı hata ayıklamayın — orada bulacağınız bir şey yok.

Geri çekilmeyle yeniden deneyin — ancak bir bütçeyle

503 tanımı gereği yeniden denenebilir. Herhangi bir 429'da kullandığınız jitter'lı üstel geri çekilmeyi kullanın (Claude 429 kılavuzumuzdaki kod parçası değişmeden çalışır — 500 sınıfı durumları zaten yeniden dener), ancak toplam beklemeyi çağıranınızın tolere edebileceği süreyle sınırlayın; yaklaşık bir dakika boyunca 5 denemeden uzun süren aşırı yüklenme kısa sürede geçmeyecektir.

Yeniden denemeler tükendiğinde: döngüyü değil modeli değiştirin

İhtiyaç duymadan önce bir geri dönüş zinciri hazırlayın: önizleme derlemesindeyseniz kararlı takma ad, 2.5 Pro zorlanıyorsa gemini-2-5-flash (veya tersi) ya da başarısız olmaması gereken istek için tamamen farklı bir sağlayıcı. Geri dönüşler kesintiyi kalite düşüşüne dönüştürür.

Kunavo üzerinden çağrı yapıyorsanız

Kunavo'nun isteğin içinde yeniden deneme yapmasının nedeni bu hata türüdür: bir model için birden fazla upstream kanalı yapılandırıldığında, başarısız bir deneme siz hatayı görmeden önce diğer kanala geçer — geçici upstream hatası 503 yerine daha yavaş bir başarıya dönüşür. Başarısız istekler hiçbir zaman ücretlendirilmez ve tek anahtar Gemini, Claude ve GPT'yi kapsadığı için 3. adımdaki sağlayıcılar arası geri dönüş, ikinci bir entegrasyon yerine model dizesi değişikliğidir. Bir geri dönüş modelini mi değerlendiriyorsunuz? Google'ın liste fiyatlarının yanında tüm Gemini ailesi için token başına ücretler Gemini API fiyat listesinde.

Sık sorulan sorular

503 döndüren istekler için ücretlendirilir miyim?

Hayır — istek çıkarımdan önce reddedilir; bu nedenle Google ücretlendirme yapmaz ve Kunavo'da da başarısız istekler hiçbir zaman ücretlendirilmez. 503'ün maliyeti tokenlar değil, gecikme ve yeniden denemelerdir.

Gemini aşırı yüklenmeleri ne kadar sürer?

Genellikle birkaç saniye ile birkaç dakika; yeni bir modelin lansman günündeki ani yük artışları daha uzun sürebilir. Bu nedenle makul politika, sınırsız bir yeniden deneme döngüsü değil, birkaç geri çekilmeli yeniden deneme ve ardından bir geri dönüş modelidir.

Ücretli pakete geçmek 503'leri durdurur mu?

Hayır. Ücretli paketler kotalarınızı artırır (429 ailesi), ancak 503 UNAVAILABLE paylaşılan sunum kapasitesidir — bir havuz dolduğunda ücretsiz ve ücretli trafik bunu görür. Çözüm faturalandırma değil, geri dönüşlerdir.

İlgili kılavuzlar

Hata anlamlarına ilişkin daha fazla bilgi hata referansı bölümünde; anahtar almak kayıt ve kimlik doğrulama kılavuzu üzerinden bir dakika sürer.