Claude API 529 overloaded_error — ne anlama gelir ve nasıl aşılır?

Kesintiyi büyütmeyen yeniden denemeler tasarlayın

529'u “Retry-After içermeyen 429” gibi ele alın. Yaklaşık 2 saniyeden başlayan üstel geri çekilme, jitter uygulama, üst sınırı 30–60 saniye belirleme, yaklaşık beş denemeden sonra vazgeçip işi kuyruğa alma. Anahtar nokta jitter'dır. Jitter olmazsa tüm istemciler aynı anda geri döner ve kurtulmaya çalıştığınız aşırı yüklenmeyi olduğu gibi uzatırlar.

Düşürmek yerine devredin

Gecikmeye duyarlı yollar için bir geri dönüş zinciri tanımlayın. OpenAI uyumlu bir uç nokta kullanıyorsanız değişiklik yalnızca tek bir dizedir — yeni SDK veya hesap oluşturmanız 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

Kodumdan şüphelenmek son çare olmalı

529 yalnızca belirli istek türlerinde görülüyor ve aynı anda yapılan diğer çağrılar başarılı oluyorsa bu tam kapsamlı bir kesinti değildir. Bu yolun olağandışı büyük istemler gönderip göndermediğini veya dar bir döngü içinde art arda çağrı yapıp yapmadığını kontrol edin. Buna karşılık tüm çağrılar bir anda 529'a dönüyor ve sonra kendiliğinden düzeliyorsa neden kapasitedir. O durumda düzeltilmesi gereken şey yeniden denemeler ve geri dönüştür; yeniden düzenleme değil.

529 benim hatam mı?

Hayır. Bu, sağlayıcı tarafındaki kapasite sorunudur. Sizin yalnızca iki sorumluluğunuz vardır — kesintiyi büyütmemek (geri çekilme ve jitter) ve kesinti gecikme bütçenizi aştığında kullanabileceğiniz bir alternatif yol bulundurmak.

529 ile 429 arasındaki fark nedir?

429, kendi limitinizi aştığınız ve sunucunun normal olduğu anlamına gelir. 529, sunucunun kendisinin aşırı yüklendiği ve kendi limitinizin normal olduğu anlamına gelir. Her ikisi de yeniden denenebilir; ancak Retry-After ipucuyla birlikte gelen yalnızca 429'dur.

529 durumu genellikle ne kadar sürer?

Öngörülemez ve garanti edilemez. Bu yüzden doğru çözüm, kod içine sabit bir bekleme süresi yerleştirmek değil, üst sınırı olan geri çekilme ve kuyruktur. İlgili yolun gecikme bütçesi varsa beklemek yerine geri dönüş devreye girer.

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

Kunavo üzerinden geçiyorsa ücretlendirilmez. Hata ile sonuçlanan istekler faturalandırılmaz. Doğrudan sözleşmeniz varsa her sağlayıcının ücretlendirme kurallarına uyulur.