Claude API 529 overloaded_error — apa artinya dan cara melewatinya

529 adalah satu-satunya kesalahan Claude yang tidak disebabkan oleh kode Anda: Anthropic sendiri sedang kelebihan beban. Anda tidak dapat memperbaikinya — hanya dapat menanganinya dengan baik. Artinya, lakukan percobaan ulang dengan sabar, gunakan model cadangan, dan jangan pernah memperparah gangguan dengan lonjakan percobaan ulang instan.

Error

respons (HTTP 529)

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

Ringkasan penyebab dan perbaikan

Penyebab	Perbaikan
Kejenuhan di sisi penyedia (hari peluncuran, gangguan regional)	Gunakan backoff dengan jitter; periksa halaman status penyedia alih-alih men-deploy ulang aplikasi.
Burst Anda tiba saat terjadi gangguan ringan	Sebarkan pekerjaan batch; penundaan 10 menit biasanya sudah cukup untuk mengatasinya.

Lakukan percobaan ulang dengan bijak

Perlakukan 529 seperti 429-tanpa-retry-after: exponential backoff mulai sekitar 2 detik, jitter, batas 30–60 detik, menyerah setelah sekitar 5 percobaan, lalu masukkan pekerjaan ke antrean. Potongan backoff dari panduan 429 kami menangani 529 pada cabang yang sama.

Beralih, jangan gagal total

Untuk jalur yang sensitif terhadap latensi, tentukan fallback: keluarga yang sama (Sonnet → Haiku) mempertahankan perilaku tetap dekat; lintas penyedia (Claude → GPT) bertahan saat seluruh penyedia mengalami gangguan. Pada endpoint yang kompatibel dengan OpenAI, cukup ubah satu string:

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

Jika Anda melakukan panggilan melalui Kunavo

Kunavo merutekan Claude melalui lebih dari satu jalur upstream, dan katalog multi-modelnya membuat failover lintas penyedia cukup dengan mengubah string model menggunakan kunci dan dompet yang sama — pola failover di atas tidak memerlukan akun kedua. 529 yang sampai kepada Anda tetap tidak pernah ditagihkan. Kapasitas dan harga adalah pertanyaan yang terpisah; untuk pertanyaan kedua, tarif per model tercantum dalam Daftar harga Claude API Anthropic.

Pertanyaan umum

Apakah 529 kesalahan saya?

Tidak. Ini kapasitas di sisi penyedia. Satu-satunya tanggung jawab Anda adalah tidak memperparahnya (backoff, jitter) dan memiliki tempat untuk beralih jika gangguan berlangsung lebih lama daripada anggaran latensi Anda.

529 vs 429 — apa perbedaannya?

429 berarti Anda melewati batas Anda (server baik-baik saja); 529 berarti server itu sendiri kelebihan beban (kuota Anda baik-baik saja). Keduanya dapat dicoba ulang; hanya 429 yang disertai petunjuk retry-after.

Panduan terkait

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