Claude 529 overloaded_error — neden ve doğru yeniden deneme stratejisi

529, kodunuzun neden olmadığı tek Claude hatasıdır: Anthropic’in kendisi aşırı yük altındadır. Bunu düzeltemezsiniz — yalnızca düzgün şekilde karşılayabilirsiniz. Bunun anlamı, backoff ile sabırlı yeniden denemeler, gecikmeye duyarlı yollar için bir yedek model ve olayı daha da kötüleştiren anlık retry fırtınalarından kesinlikle kaçınmaktır.

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 yoğunluk (lansman günleri, bölgesel kesintiler). Tüm müşterileri aynı anda etkiler.	Jitter içeren backoff uygulayın; kendi uygulamanızı yeniden dağıtmak yerine Anthropic’in durum sayfasını kontrol edin.
Kendi yük artışınız zaten gerilmiş bir kapasiteyle çakışır.	Toplu işleri zamana yayın; on dakikalık bir gecikme genellikle sorunu ortadan kaldırır.
429 ile karıştırma: hız limiti günlüklerde benzer görünür, ancak nedeni tamamen farklıdır.	429, limitlerinizi aştığınız anlamına gelir (sunucu sağlıklıdır); 529 ise sunucunun aşırı yüklendiği anlamına gelir (kotanız normaldir). Yalnızca 429 bir Retry-After ipucu sağlar.
Yedek tanımlanmadığı için sağlayıcı sorunu son kullanıcıya kadar ulaşır.	Bir yedek zinciri belirleyin — aynı aile içinde (Sonnet → Haiku) davranış benzer kalır; sağlayıcılar arasında (Claude → GPT) ise tam bir kesintiyi de atlatabilirsiniz.

Kesintiyi büyütmeden yeniden denemek

529’u Retry-After içermeyen bir 429 gibi ele alın: yaklaşık 2 saniyeden başlayan, jitter içeren, 30–60 saniyede sınırlanan üstel backoff uygulayın; yaklaşık beş denemeden sonra vazgeçip işi kuyruğa alın. Kritik nokta jitter’dır: jitter olmadan tüm istemciler aynı anda geri gelir ve kaçmaya çalıştıkları aşırı yükü tam olarak uzatırlar.

Kesinti yerine yedek modele geçin

Gecikmeye duyarlı yollar için bir yedek zinciri tanımlayın. OpenAI uyumlu bir uç noktada bu, yalnızca tek bir karakter dizisini değiştirmek demektir — ikinci SDK veya ikinci hesap 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          # überlastet — nächste Stufe versuchen
    raise last

Ancak bundan sonra kendi kodunuza bakın

529 yalnızca tek bir istek türünde oluşuyor ve aynı anda diğer çağrılar başarılı oluyorsa bu sağlayıcı genelinde bir kesinti değildir: Bu yolun alışılmadık derecede büyük istemler gönderip göndermediğini veya dar bir döngü içinde çalışıp çalışmadığını kontrol edin. Buna karşılık hata tüm çağrılarda aynı anda oluşuyor ve kendiliğinden kayboluyorsa sorun kapasitedir — bu durumda iş retry ve fallback’e ait olur, yeniden düzenlemeye değil.

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

Kunavo, Claude’u birden fazla upstream yolu üzerinden çalıştırır; çok modelli katalog sayesinde sağlayıcılar arası yük devretme, aynı anahtar ve aynı faturalandırma üzerinde yalnızca model adını değiştirmektir — yukarıdaki yaklaşım ikinci hesap gerektirmez. Size ulaşan 529 hataları yine de hiçbir zaman ücretlendirilmez. Kapasite ve fiyat iki ayrı sorudur; ikinci konu için model bazındaki oranlar şu sayfada yer alır: Claude API fiyat listesi.

Sık sorulan sorular

529 benim hatam mı?

Hayır. Sorun sağlayıcı tarafındaki kapasitedir. Sizin sorumluluğunuz, kesintiyi büyütmemekle (backoff, jitter) ve olay gecikme bütçenizden uzun sürerse kullanılacak bir yedek hedefe sahip olmakla sınırlıdır.

529 veya 429 — fark nedir?

429, limitlerinizi aştığınız ve sunucunun sağlıklı olduğu anlamına gelir. 529, sunucunun kendisinin aşırı yüklendiği ve kotanızın normal olduğu anlamına gelir. Her ikisi de yeniden denenebilir; ancak yalnızca 429 bir Retry-After ipucuyla birlikte gelir.

529 dönemi genellikle ne kadar sürer?

Bu öngörülemez ve garanti edilemez; bu nedenle doğru yanıt, koda sabit bir bekleme süresi yazmak değil, sınırlı bir backoff ile kuyruk kullanmaktır. Yolunuzun gecikme bütçesi varsa beklemek yerine fallback devreye girer.

Başarısız 529 çağrıları ücretlendirilir mi?

Kunavo üzerinden hayır: hatayla sonuçlanan bir istek ücretlendirilmez. Doğrudan sözleşmede ise bu, ilgili sağlayıcının faturalandırma kurallarına bağlıdır.

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