Claude 529 overloaded_error hatası — neden ve yeniden deneme stratejisi

529, kodunuzun neden olmadığı tek Claude hatasıdır: aşırı yük Anthropic tarafındadır. Bunu düzeltemezsiniz — yalnızca zarif biçimde absorbe edebilirsiniz. Bu; sabırlı backoff'lu yeniden denemeler, gecikmeye duyarlı yollarda bir yedek model ve her şeyden önemlisi sorunu büyüten ani yeniden deneme patlamalarından kaçınmak demektir.

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 aşırı yük (lansman günleri, bölgesel kesintiler). Aynı anda tüm müşterileri etkiler.	Jitter'lı backoff kullanın; uygulamanızı yeniden dağıtmak yerine Anthropic'in durum sayfasını kontrol edin.
Kendi yük zirveniz zaten zorlanan kapasiteye eklenir.	İşleri toplu olarak dağıtın; on dakikalık gecikmeler genellikle sorunu çözer.
429 ile karıştırma: günlüklerde hız sınırı benzer görünebilir, ancak neden tamamen farklıdır.	429, sınırlarınızı aştığınız anlamına gelir (sunucu iyi durumdadır); 529, sunucunun aşırı yüklendiği anlamına gelir (kotanız iyidir). Yalnızca 429 Retry-After ipucu taşır.
Tanımlı bir yedek yoktur; bu nedenle sağlayıcı sorunu son kullanıcıya kadar ulaşır.	Bir yedek zinciri tanımlayın — aynı aile içinde (Sonnet → Haiku) davranış benzer kalır; sağlayıcılar arasında (Claude → GPT) ise tam bir kesintiden kurtulursunuz.

Sorunu büyütmeden yeniden denemek

529'u Retry-After içermeyen bir 429 gibi ele alın: yaklaşık 2 saniyeden başlayan, jitter'lı üstel backoff kullanın; üst sınırı 30–60 saniye olsun, yaklaşık beş denemeden sonra vazgeçip işi kuyruğa alın. Önemli olan jitter'dır: Jitter olmazsa tüm istemciler aynı anda geri döner ve kurtulmaya çalıştıkları aşırı yükü tam olarak uzatırlar.

Düşmek yerine geçiş yapmak

Gecikmeye duyarlı yollarda bir yedek zinciri tanımlayın. OpenAI uyumlu bir uç noktada bu yalnızca tek bir metin zincirini değiştirmek demektir — ikinci SDK ve 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          # saturado — probar el siguiente nivel
    raise last

Ancak bundan sonra kodunuza bakın

529'lar yalnızca bir istek türünde görünürken diğer çağrılar aynı anda başarılı oluyorsa bu genel bir kesinti değildir: o yolun alışılmadık derecede büyük istemler gönderip göndermediğini veya kapalı bir döngü içinde tetiklenip tetiklenmediğini kontrol edin. Buna karşılık tüm çağrıları birden etkileyip kendiliğinden kayboluyorsa sorun kapasitedir — bu durumda iş yeniden deneme ve yedek mekanizmasına aittir, yeniden düzenlemeye değil.

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

Kunavo, Claude'u birden fazla kaynak yolu üzerinden yönlendirir; çok modelli kataloğu da sağlayıcılar arasında geçişi aynı anahtar ve aynı bakiye üzerinde yalnızca model adını değiştirme işlemine dönüştürür — yukarıdaki yaklaşım ikinci hesap gerektirmez. Buna rağmen size ulaşan 529'lar hiçbir zaman ücretlendirilmez. Kapasite ve fiyat farklı sorulardır; ikinci soru için model ücretleri burada bulunur: Claude fiyatları.

Sık sorulan sorular

529 benim hatam mı?

Hayır. Bu, sağlayıcı tarafındaki kapasite sorunudur. Tek sorumluluğunuz olayı büyütmemek (backoff, jitter) ve kesinti gecikme bütçenizden uzun sürerse kullanabileceğiniz bir çıkış yolu bulundurmaktır.

529 ile 429 arasındaki fark nedir?

429, sınırlarınızı aştığınız; sunucunun iyi durumda olduğu anlamına gelir. 529, sunucunun kendisinin aşırı yüklendiği; kotanızın iyi olduğu anlamına gelir. İkisi de yeniden denenebilir; yalnızca 429 Retry-After ipucuyla gelir.

529 olayı normalde ne kadar sürer?

Öngörülemez ve garanti edilemez — doğru yanıt bu nedenle koda sabitlenmiş bir bekleme değil, üst sınırlı backoff ve kuyruktur. Yolunuzun gecikme bütçesi varsa beklemek yerine yedek devreye girer.

529 ile sonuçlanan çağrılar ücretlendirilir mi?

Kunavo üzerinden hayır: hatayla sonuçlanan bir istek ücretlendirilmez. Doğrudan sözleşmede ise 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.