Error Claude 529 overloaded_error — penyebab dan strategi retry

529 adalah satu-satunya error Claude yang tidak disebabkan oleh kode Anda: Anthropic sedang kelebihan beban. Anda tidak dapat memperbaikinya — hanya menanganinya dengan benar. Artinya adalah melakukan retry dengan sabar menggunakan backoff, memakai model cadangan pada jalur yang sensitif terhadap latensi, dan sama sekali tidak membuat lonjakan retry langsung yang memperbesar 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 pada saat yang sama.	Gunakan backoff dengan jitter; lihat halaman status Anthropic, bukan menerapkan ulang aplikasi Anda.
Lonjakan beban Anda sendiri terjadi saat kapasitas sudah berada di bawah tekanan.	Sebarkan pemrosesan batch; penundaan sepuluh menit biasanya sudah cukup.
Kebingungan dengan 429: rate limit terlihat seperti ini di log, tetapi penyebabnya tidak berkaitan.	429 berarti Anda telah melampaui batas (server baik-baik saja); 529 berarti server sedang kelebihan beban (kuota Anda baik-baik saja). Hanya 429 yang disertai petunjuk Retry-After.
Tidak ada fallback yang ditentukan, sehingga masalah penyedia diteruskan sampai ke pengguna akhir.	Tentukan rantai fallback — dalam keluarga yang sama (Sonnet → Haiku), perilakunya tetap mirip; lintas penyedia (Claude → GPT), Anda dapat bertahan dari insiden total.

Lakukan retry tanpa memperparah insiden

Perlakukan 529 seperti 429 tanpa Retry-After: gunakan exponential backoff mulai sekitar 2 detik, dengan jitter, dibatasi pada 30–60 detik, berhenti setelah sekitar lima percobaan, lalu masukkan pekerjaan ke antrean. Jitter adalah bagian yang penting: tanpanya, semua klien kembali secara bersamaan dan memperpanjang tepat kelebihan beban yang ingin mereka hindari.

Beralih daripada gagal

Pada jalur yang sensitif terhadap latensi, tentukan rantai fallback. Pada endpoint yang kompatibel dengan OpenAI, ini hanya memerlukan perubahan 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          # saturé — passer au palier suivant
    raise last

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 luar biasa besar atau memicu loop yang terlalu rapat. Sebaliknya, jika semua panggilan terdampak sekaligus lalu pulih sendiri, penyebabnya adalah kapasitas — pekerjaan tersebut harus ditangani dengan retry dan fallback, bukan perombakan kode.

Jika Anda melakukan panggilan melalui Kunavo

Kunavo meneruskan Claude melalui lebih dari satu jalur upstream, dan katalog multi-modelnya menjadikan perpindahan lintas penyedia cukup dengan mengganti nama model pada kunci dan dompet yang sama — pola di atas tidak memerlukan akun kedua. Error 529 yang tetap sampai kepada Anda tidak pernah ditagihkan. Kapasitas dan harga adalah dua hal yang berbeda; untuk yang kedua, tarif per model tersedia di daftar tarif API Claude.

Pertanyaan umum

Apakah 529 adalah kesalahan saya?

Tidak. Ini adalah masalah kapasitas di sisi penyedia. Satu-satunya tanggung jawab Anda adalah tidak memperparah insiden (backoff, jitter) dan memiliki tujuan cadangan jika insiden berlangsung lebih lama daripada anggaran latensi Anda.

529 atau 429 — apa perbedaannya?

429 berarti Anda telah melampaui batas, sedangkan server sehat. 529 berarti server itu sendiri sedang kelebihan beban, sementara kuota Anda baik-baik saja. Keduanya dapat dicoba ulang; hanya 429 yang memberikan petunjuk Retry-After.

Berapa lama periode 529 berlangsung?

Hal ini tidak dapat diprediksi dan tidak dapat dijamin — karena itu, respons yang tepat adalah backoff yang dibatasi ditambah antrean, bukan jeda yang ditulis secara hard-code dalam kode. Jika jalur Anda memiliki anggaran latensi, fallback akan mengambil alih alih-alih menunggu.

Apakah panggilan 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.