Claude 529 overloaded_error — neden ve yeniden deneme stratejisi

529, kodunuzun neden olmadığı tek Claude hatasıdır: aşırı yüklenen Anthropic’tir. 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ı büyüten anlık retry dalgaları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 olaylar). Tüm müşterileri aynı anda etkiler.	Jitter içeren backoff uygulayın; 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şlemleri zamana yayın; on dakikalık bir gecikme genellikle yeterlidir.
429 ile karıştırma: günlüklerde hız limiti buna benzer görünür, ancak nedeni tamamen farklıdır.	429, limitlerinizi aştığınız (sunucu sağlıklı) anlamına gelir; 529, sunucunun aşırı yüklendiği (kotanız normal) anlamına gelir. Yalnızca 429 bir Retry-After ipucuyla birlikte gelir.
Yedek tanımlanmadığı için sağlayıcı sorunu son kullanıcıya 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) tam bir olayı 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. Jitter en önemli kısımdır: jitter olmadan tüm istemciler aynı anda geri gelir ve kaçmaya çalıştıkları aşırı yükü tam olarak uzatırlar.

Kesilmek 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          # saturé — passer au palier suivant
    raise last

Ve ancak bundan sonra kodunuza bakın

529 yalnızca tek 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: bu yolun alışılmadık derecede büyük istemler gönderip göndermediğini veya sıkı bir döngüde çalışıp çalışmadığını kontrol edin. Tersine, sorun tüm çağrıları aynı anda etkileyip kendiliğinden ortadan kalkıyorsa bu kapasite kaynaklıydı — iş yeniden deneme ve geri dönüş mekanizmasına aittir, yeniden tasarıma değil.

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

Kunavo, Claude'u birden fazla upstream yol üzerinden yönlendirir ve çok modelli kataloğu, sağlayıcılar arasında geçişi aynı anahtar ve aynı cüzdanda yalnızca model adını değiştirmek kadar basit hale getirir — yukarıdaki şemanın ikinci bir hesaba ihtiyacı yoktur. Size ulaşan 529 hataları hiçbir zaman ücretlendirilmez. Kapasite ve fiyat iki ayrı konudur; ikincisi için model bazlı ücretler şurada yer alır: Claude API fiyatlandırma tablosu.

Sık sorulan sorular

529 benim hatam mı?

Hayır. Bu, sağlayıcı tarafındaki kapasite sorunudur. Sizin tek sorumluluklarınız kesintiyi büyütmemek (backoff, jitter) ve kesinti gecikme bütçenizden uzun sürerse devreye girecek bir yedek yol bulundurmaktır.

529 ile 429 arasındaki fark nedir?

429, limitlerinizi aştığınız, sunucunun iyi durumda olduğu anlamına gelir. 529, sunucunun kendisinin aşırı yüklendiği, kotanızın iyi durumda olduğu anlamına gelir. Her ikisi de yeniden denenebilir; yalnızca 429, Retry-After ipucunu sağlar.

529 dönemi ne kadar sürer?

Öngörülemez ve garanti edilemez — bu nedenle doğru yanıt, koda sabit bir süre yazmak değil, üst sınırı belirlenmiş bir backoff ile kuyruk kullanmaktır. Yolunuzun bir gecikme bütçesi varsa beklemek yerine geri dönüş mekanizması devreye girer.

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.