Claude 529 hatası (overloaded_error): nedenleri ve çözümü

529, sizin kodunuzdan kaynaklanmayan tek Claude hatasıdır: dolu olan Anthropic'in tarafıdır. Bunu düzeltemezsiniz; yalnızca zarifçe yönetebilirsiniz — geri çekilmeli sabırlı yeniden denemeler, gecikmeye duyarlı yollar için hazır bir yedek model ve bu arızayı anında art arda yeniden denemelerle büyütmemek.

Hata

Yanıt (HTTP 529)

{
  "type": "error",
  "error": { "type": "overloaded_error",
             "message": "Overloaded" }
}

Nedenler ve çözümler özeti

Neden	Çözüm
Sağlayıcı tarafında kapasite doluluğu (yeni model yayın günü, bölgesel arıza). Tüm müşteriler aynı anda etkilenir.	Jitter içeren geri çekilmeli bekleme kullanın; kendi uygulamanızı yeniden dağıtmak yerine Anthropic'in durum sayfasını kontrol edin.
Kendi yoğun trafiğiniz zaten zorlanan kapasiteyle tam aynı anda çakışıyordur.	Toplu işleri zamana yayın; genellikle on dakika ertelemek sorunu geçirir.
429 ile karıştırmak. Günlüklerde ikisi birbirine çok benzer görünür, ancak nedenleri tamamen farklıdır.	429, kendi sınırınızı aştığınız anlamına gelir (sunucu sağlıklıdır); 529 ise sunucunun kendisinin aşırı yüklendiği anlamına gelir (kotanızda sorun yoktur). Yalnızca 429 Retry-After ipucunu içerir.
Yedek tanımlanmamışsa sağlayıcı sorunu son kullanıcıya kadar ulaşır.	Yedekleme sırasını önceden belirleyin — aynı seri (Sonnet → Haiku) daha benzer davranır; sağlayıcılar arası geçiş (Claude → GPT) ise tüm sağlayıcının devre dışı kaldığı durumları atlatabilir.

Yeniden denemelerin arızayı büyütmesini önlemek

529'u Retry-After içermeyen bir 429 gibi ele alın: yaklaşık 2 saniyeden başlayan üstel geri çekilme, jitter, 30–60 saniyelik üst sınır; yaklaşık beş denemeden sonra vazgeçip işi kuyruğa alın. Gerçekten etkili olan jitter kısmıdır: bu olmadan tüm istemciler aynı anda geri döner ve kaçmaya çalıştıkları tıkanıklığı aynen uzatırlar.

Çökmeyin, etrafından dolaşın

Gecikmeye duyarlı yollar için yedek zincirini önceden tanımlayın. OpenAI uyumlu uç noktalarda bu yalnızca bir dizeyi değiştirmek demektir — başka bir SDK'ya bağlanmanız veya başka bir hesap açmanız gerekmez:

failover.py

PREFERRED = ["claude-sonnet-5", "claude-haiku-4-5", "gpt-5-6-terra"]

def complete(messages):
    last = None
    for model in PREFERRED:
        try:
            return client.chat.completions.create(
                model=model, messages=messages, max_tokens=800)
        except APIStatusError as e:
            if e.status_code not in (429, 500, 529):
                raise
            last = e          # 過載 —— 試下一個
    raise last

Ancak en son kendi kodunuzdan şüphe edin

Yalnızca belirli bir istek türü 529 alıyor ve aynı anda diğer çağrılar sorunsuz geçiyorsa bu genel bir arıza değildir: o yolun olağanüstü büyük istemler gönderip göndermediğini veya çok kısa bir döngüde art arda gönderim yapıp yapmadığını kontrol edin. Buna karşılık tüm çağrılar aynı anda 529 almaya başlayıp bir süre sonra kendiliğinden düzeliyorsa neden kapasitedir — değiştirmeniz gereken yeniden deneme ve yedeklemedir, yeniden yapılandırma değil.

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

Kunavo, Claude'u birden fazla üst akış yoluna dağıtır; çok modelli katalog ise sağlayıcılar arası yedeklemeyi "aynı anahtar, aynı bakiye, yalnızca model adını değiştir" haline getirir — yukarıdaki kodun ikinci bir hesaba ihtiyacı yoktur. 529 yine de size ulaşsa bile hiçbir zaman ücretlendirilmez. Kapasite ve fiyat iki ayrı sorundur; ikincisiyle ilgili olarak her modelin birim fiyatı şurada listelenmiştir: Claude API ücret tablosu.

Sık sorulan sorular

529 benim sorunum mu?

Hayır. Bu, sağlayıcı tarafındaki bir kapasite sorunudur. Sizin tarafınızdaki iki sorumluluk şunlardır: arızayı büyütmemek (geri çekilme ve jitter) ve arıza gecikme bütçenizi aştığında dolaşabileceğiniz bir yolun bulunması.

529 ile 429 arasındaki fark nedir?

429, kendi sınırınızı aştığınız anlamına gelir ve sunucu sağlıklıdır; 529, sunucunun kendisinin aşırı yüklendiği ve kotanızda sorun olmadığı anlamına gelir. İkisi de yeniden denenebilir, ancak yalnızca 429 Retry-After ipucunu içerir.

529 genellikle ne kadar sürer?

Öngörülemez ve garanti edilemez — bu nedenle doğru yanıt, kodda sabit bir bekleme süresi yazmak değil, "üst sınırı olan geri çekilme ve kuyruk" kullanmaktır. Bu yolun bir gecikme bütçesi varsa devralması gereken yedektir, beklemek değil.

529 ile başarısız olan çağrılar ücretlendirilir mi?

Kunavo üzerinden hayır: hatayla sonuçlanan istekler faturalandırmaya dahil edilmez. Doğrudan sağlayıcıyla sözleşme yaptıysanız, ilgili sağlayıcının faturalandırma kuralları geçerlidir.

İ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.

Claude API 529 overloaded_error — bu hata ne anlama gelir ve nasıl atlatılır