Error Claude 529 overloaded_error—penyebab dan strategi percobaan ulang

529 adalah satu-satunya error Claude yang tidak disebabkan oleh kode Anda: Anthropic-lah yang kelebihan beban. Anda tidak dapat memperbaikinya—hanya menanganinya dengan elegan. Artinya, gunakan percobaan ulang yang sabar dengan backoff, model cadangan untuk jalur yang sensitif terhadap latensi, dan terutama jangan membuat lonjakan percobaan ulang langsung yang memperparah insiden.

Error

respons (HTTP 529)

{
  "type": "error",
  "error": { "type": "overloaded_error",
             "message": "Overloaded" }
}

Ringkasan penyebab dan perbaikan

Penyebab	Perbaikan
Kelebihan beban di sisi penyedia (hari peluncuran, insiden regional). Berdampak pada semua pelanggan secara bersamaan.	Backoff dengan jitter; periksa halaman status Anthropic alih-alih melakukan deployment ulang aplikasi.
Lonjakan beban Anda sendiri bertemu kapasitas yang sudah tegang.	Sebarkan pekerjaan dalam batch; penundaan sepuluh menit biasanya cukup untuk mengatasinya.
Tertukar dengan 429: di log, pembatasan laju terlihat serupa, tetapi penyebabnya sepenuhnya berbeda.	429 berarti Anda melampaui batas Anda (server baik-baik saja); 529 berarti server kelebihan beban (kuota Anda baik-baik saja). Hanya 429 yang menyertakan petunjuk Retry-After.
Tidak ada cadangan yang ditentukan, sehingga masalah penyedia mencapai pengguna akhir.	Tentukan rantai cadangan—dalam keluarga yang sama (Sonnet → Haiku), perilakunya tetap mirip; lintas penyedia (Claude → GPT), Anda dapat bertahan dari insiden penuh.

Melakukan percobaan ulang tanpa memperparah insiden

Perlakukan 529 seperti 429 tanpa Retry-After: gunakan backoff eksponensial mulai sekitar 2 detik, dengan jitter, batas 30–60 detik, berhenti setelah sekitar lima percobaan, lalu antrekan pekerjaan. Jitter adalah bagian pentingnya: tanpanya, semua klien kembali bersamaan dan memperpanjang kelebihan beban yang sedang mereka coba atasi.

Beralih, bukan gagal

Untuk jalur yang sensitif terhadap latensi, tentukan rantai cadangan. Pada endpoint yang kompatibel dengan OpenAI, itu hanya berarti mengganti satu string—tanpa SDK kedua dan tanpa akun kedua:

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

Dan baru setelah itu periksa kode Anda

Jika 529 hanya muncul pada satu jenis permintaan sementara panggilan lain berhasil pada saat yang sama, ini bukan insiden umum: periksa apakah jalur tersebut mengirim prompt yang sangat besar atau berjalan dalam loop tertutup. Sebaliknya, jika semua panggilan terdampak sekaligus lalu pulih sendiri, masalahnya adalah kapasitas—dan pekerjaan yang tepat adalah percobaan ulang serta cadangan, bukan refaktor.

Jika Anda melakukan panggilan melalui Kunavo

Kunavo merutekan Claude melalui lebih dari satu jalur asal, dan katalog multimodelnya menjadikan perpindahan penyedia cukup dengan mengganti nama model menggunakan kunci dan dompet yang sama — pola di atas tidak memerlukan akun kedua. Error 529 yang tetap Anda terima tidak pernah ditagihkan. Kapasitas dan harga adalah dua pertanyaan berbeda; untuk pertanyaan kedua, tarif per model tersedia di harga Claude.

Pertanyaan umum

Apakah error 529 kesalahan saya?

Tidak. Itu adalah masalah kapasitas di sisi penyedia. Tanggung jawab Anda hanya tidak memperparah insiden (backoff, jitter) dan memiliki jalur cadangan jika insiden berlangsung lebih lama daripada anggaran latensi Anda.

529 vs 429, apa bedanya?

429 berarti Anda melampaui batas Anda; server baik-baik saja. 529 berarti server itu sendiri sedang kelebihan beban; kuota Anda baik-baik saja. Keduanya dapat dicoba ulang; hanya 429 yang disertai petunjuk Retry-After.

Biasanya berapa lama episode 529 berlangsung?

Durasi ini tidak dapat diprediksi atau dijamin — itulah sebabnya respons yang benar adalah backoff dengan batas maksimum ditambah antrean, bukan waktu tunggu yang ditulis permanen di kode. Jika rute Anda memiliki anggaran latensi, jalur cadangan mengambil alih alih-alih terus menunggu.

Apakah panggilan yang berakhir dengan 529 ditagihkan?

Melalui Kunavo: tidak. Permintaan yang berakhir dengan error tidak ditagihkan. Dalam kontrak langsung, hal ini bergantung pada aturan penagihan penyedia terkait.

Panduan terkait

Detail semantik error lainnya tersedia di referensi error; mendapatkan kunci hanya perlu satu menit melalui pendaftaran dan panduan autentikasi.