Claude API 529 overloaded_error — nedir ve nasıl atlatılır

529, kodunuzun neden olmadığı tek Claude hatasıdır: Anthropic'in kendisi aşırı yüklenmiştir. Bunu düzeltemezsiniz — yalnızca zarif biçimde karşılayabilirsiniz. Bunun anlamı sabırlı yeniden denemeler, bir geri dönüş modeli ve anlık yeniden deneme fırtınalarıyla kesintiyi asla büyütmemektir.

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 doygunluk (lansman günleri, bölgesel kesintiler)	Jitter ile geri çekilin; uygulamayı yeniden dağıtmak yerine sağlayıcının durum sayfasını kontrol edin.
Ani trafik artışınızın geçici bir kesintiye denk gelmesi	Toplu işleri zamana yayın; 10 dakikalık bir gecikme genellikle sorunu temizler.

İyi bir yurttaş gibi yeniden deneyin

529'u Retry-After içermeyen 429 gibi ele alın: yaklaşık 2 saniyeden başlayan üstel geri çekilme, jitter, 30–60 saniyelik üst sınır, yaklaşık 5 denemeden sonra vazgeçme ve işi kuyruğa alma. 429 kılavuzumuzdaki geri çekilme parçacığı, aynı dalda 529'u da ele alır.

Başarısız olmak yerine devredin

Gecikmeye duyarlı yollar için bir geri dönüş tanımlayın: aynı aile (Sonnet → Haiku) davranışı benzer tutar; sağlayıcılar arası geçiş (Claude → GPT) sağlayıcının tamamını etkileyen bir kesintiden kurtulur. OpenAI uyumlu bir uç noktada bu, tek bir dizeyi değiştirmek demektir:

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          # saturated — try the next tier
    raise last

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

Kunavo, Claude'u birden fazla üst akış yoluna yönlendirir ve çok modelli kataloğu, sağlayıcılar arası geçişi aynı anahtar ve cüzdanda yalnızca model dizesini değiştirme işlemine dönüştürür — yukarıdaki geçiş düzeni için ikinci bir hesaba gerek yoktur. Size ulaşan 529'lar yine asla faturalandırılmaz. Kapasite ve fiyat ayrı sorulardır; ikinci sorunun model başına ücretleri şurada yer alır: Anthropic Claude API fiyat listesi.

Sık sorulan sorular

529 benim hatam mı?

Hayır. Bu, sağlayıcı tarafındaki kapasite sorunudur. Sizin tek sorumluluklarınız bunu büyütmemek (geri çekilme ve jitter) ve kesinti gecikme bütçenizi aşarsa geçiş yapabileceğiniz bir yer bulundurmaktır.

529 ile 429 arasındaki fark nedir?

429, limitlerinizi aştığınız anlamına gelir (sunucu normaldir); 529, sunucunun kendisinin aşırı yüklendiği anlamına gelir (kotanız normaldir). Her ikisi de yeniden denenebilir; ancak yeniden deneme ipucuyla gelen yalnızca 429'dur.

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