Claude API 529 overloaded_error — anlamı ve doğru çözüm

Kesintiyi kötüleştirmeyen yeniden denemeler tasarlayın

529'u "Retry-After içermeyen 429" olarak ele alın. Yaklaşık 2 saniyeden başlayan, jitter içeren üstel backoff kullanın; üst sınır 30–60 saniye olsun, yaklaşık 5 denemeden sonra vazgeçip kuyruğa aktarın. İşe yarayan kısım jitter'dır. Jitter olmazsa tüm istemciler aynı anda geri döner ve kurtulmak istediğiniz yoğunluğu uzatırlar.

Düşürmeyin, başka yere yönlendirin

Gecikmeye duyarlı yollar için bir fallback zinciri hazırlayın. OpenAI uyumlu bir uç nokta kullanıyorsanız değiştirmeniz gereken yalnızca tek bir dizedir — SDK veya hesap eklemeniz gerekmez:

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

Kendi kodunuzdan şüphelenmek son adımdır

Yalnızca belirli bir istek türü 529 alıyor ve aynı zamandaki diğer çağrılar başarılı oluyorsa bu genel bir kesinti değildir. Bu yolun olağandışı derecede büyük istemler gönderip göndermediğini veya kısa döngüde art arda çağrı yapıp yapmadığını kontrol edin. Buna karşılık tüm çağrılar aynı anda 529 alıyor ve bir süre sonra kendiliğinden düzeliyorsa neden kapasitedir. Bu durumda dokunmanız gereken şey yeniden deneme ve fallback'tir; yeniden düzenleme değil.

529 benim hatam mı?

Hayır. Sorun sağlayıcı tarafındaki kapasitedir. Bizim yalnızca iki sorumluluğumuz vardır: kesintiyi büyütmemek (backoff ve jitter) ve kesinti gecikme toleransını aştığında kullanılacak bir kaçış yolu hazırlamak.

529 ile 429 arasındaki fark nedir?

429, kendi sınırınızı aştığınız anlamına gelir; sunucunun kendisi normaldir. 529, sunucunun aşırı yüklü olduğu ve sizin sınırınızın ve bakiyenizin normal olduğu anlamına gelir. İkisi de yeniden denenebilir, ancak Retry-After ipucu yalnızca 429'da bulunur.

529 genellikle ne kadar sürer?

Öngörülemez ve garanti edilemez. Bu nedenle doğru çözüm, koda sabit bir bekleme süresi yazmak değil, "üst sınırlandırılmış backoff + kuyruk" kullanmaktır. Yolun gecikme toleransı varsa beklemek yerine fallback devralır.

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

Kunavo üzerinden ücretlendirilmez. Hata ile sonuçlanan istekler faturalandırma kapsamı dışındadır. Doğrudan sözleşmelerde her sağlayıcının faturalandırma kuralları geçerlidir.