Error 429: apa yang harus dilakukan saat claude-opus-5 gagal

Kode 429 berarti batas laju tercapai: jumlah permintaan atau token dalam satu jendela waktu melebihi kuota paket Anda.

429 Too Many Requests adalah respons pembatasan laju, bukan error. Artinya permintaan valid, hanya saja melampaui laju permintaan atau konkurensi yang diizinkan paket Anda saat ini. Tunggu sesuai jendela yang ditunjukkan header lalu coba lagi; body tidak perlu diubah.

claude-opus-5 disediakan oleh Anthropic. Semua di halaman ini — penyebab, solusi, dan data terukur — disusun dari perilaku runtime nyata model ini di lapisan gateway.

Di gateway ini, pemicu yang paling umum adalah: Terlalu banyak permintaan bersamaan. Tindakan pertama yang disarankan: Batasi konkurensi dan coba ulang dengan jeda eksponensial.

Penyebab umum

  • Terlalu banyak permintaan bersamaan
  • Kuota paket saat ini habis
  • Mencoba ulang tanpa jeda

Cara mengatasi

  • Batasi konkurensi dan coba ulang dengan jeda eksponensial
  • Beralih ke paket dengan kuota lebih besar
  • Simpan cache permintaan yang berulang

Contoh percobaan ulang dengan exponential backoff

Kode di bawah mencoba ulang ketika claude-opus-5 mengembalikan 429, maksimal 5 kali, dengan waktu tunggu yang meningkat plus jitter acak agar permintaan paralel tidak mengulang bersamaan. Baca base URL dan API key dari environment variable, jangan hardcode.

import os, time, random
import requests

BASE  = os.getenv("OPENAI_BASE_URL")   # e.g. https://<your-gateway>/v1
KEY   = os.getenv("OPENAI_API_KEY")
MODEL = 'claude-opus-5'


def chat(messages, retries=5):
    """Retry with exponential backoff + jitter."""
    for i in range(retries):
        try:
            r = requests.post(
                BASE + "/chat/completions",
                headers={"Authorization": "Bearer " + KEY},
                json={"model": MODEL, "messages": messages, "stream": True},
                timeout=60,
            )
            if r.status_code == 429 or r.status_code >= 500:
                time.sleep(min(2 ** i + random.uniform(0, 1), 30))
                continue
            r.raise_for_status()
            return r.json()
        except requests.exceptions.Timeout:
            time.sleep(min(2 ** i + random.uniform(0, 1), 30))
    raise RuntimeError("gave up after " + str(retries) + " retries")


print(chat([{"role": "user", "content": "hello"}]))

Data penting model ini

Endpoint APIhttps://api.airai.cc/v1
Kompatibel OpenAIOpenAI-compatible
VendorAnthropic
Konteks1M
KemampuanReasoning, Tools, Files, Vision
Format APIopenai, openai-response, openai-response-compact, anthropic, gemini, openai-alpha-search
Rumus penagihanp * 5 + cr * 0.5 + cc * 6.25 + cc1h * 10 + c * 25

FAQ

Apakah 429 lebih sering terjadi di percakapan multi-giliran dengan claude-opus-5?

Ini masalah konfigurasi sisi klien, sisi server tidak perlu diubah. Tag kemampuan adalah Reasoning, Tools, Files, Vision, dan batas parameter mengikuti set kemampuan tersebut. Jendela konteks 1M menentukan input maksimum per permintaan; yang melebihinya langsung ditolak. Potong atau ringkas input yang panjang — ini menurunkan 429 secara nyata.

Apakah 429 di claude-opus-5 bergantung pada region atau node?

Kelompokkan error berdasarkan waktu dan node; polanya biasanya langsung terlihat. Simpan request ID dan isi respons mentahnya, kalau tidak tidak ada yang bisa dilacak. Model ini dilayani oleh Anthropic, sehingga status upstream mengikuti pengumuman penyedia. Catat request ID pada setiap kegagalan — lebih berguna daripada kode status. Reproduksi dulu di lingkungan pengujian dengan request body yang sama.

Apakah 429 pulih sendiri atau perlu tindakan manual?

Biasanya bersifat sementara dan pulih sendiri. Tag kapabilitas model ini adalah Reasoning, Tools, Files, Vision. Jika berlangsung beberapa menit, hubungi dukungan platform untuk memastikan status upstream.

Apakah permintaan yang gagal tetap dihitung dalam kuota rate limit?

Tidak ada tagihan, hanya output yang benar-benar dihasilkan yang dihitung. Hanya output yang sudah dihasilkan yang ditagihkan; bagian yang gagal tidak. Harga input sekitar $5.00 per juta token. Dengan penagihan p * 5 + cr * 0.5 + cc * 6.25 + cc1h * 10 + c * 25, permintaan yang gagal tidak dihitung dalam penggunaan. Saat memperkirakan biaya dari p * 5 + cr * 0.5 + cc * 6.25 + cc1h * 10 + c * 25, sertakan juga anggaran percobaan ulang.

Error lain pada model ini

Model lain dengan error yang sama

Kembali ke halaman model

Data diperbarui: 2026-10-10 15:45

Dukungan teknisDukungan langsung
Kembali ke atas