Cari dokumen...

Mulai mengetik untuk mencari dokumentasi

Panduan Platform

Error dan batas laju

Arti tiap kode status, dan mana yang layak dicoba ulang.

Dua batas berlaku per key: request per menit (RPM) dan request paralel (konkurensi). Keduanya berasal dari pengaturan paketmu.

Kategori paketRPM / keyKonkurensi / keyBatas context
VIP60–1405–30524K
Unlimited (reguler)303256K
Token605tanpa batas

Tabel ini dibuat dari paket yang dijual saat ini, jadi selalu sama dengan yang ditegakkan gateway. Batas nyatamu juga tampil di kartu paket dan di halaman API Key.

Gateway juga membatasi request aktif secara global. Di atas itu, request dibalas 503 gateway_busy.

Setiap penolakan membawa kode yang bisa dibaca mesin di samping status HTTP.

StatusArtiYang harus dilakukan
400invalid_body atau invalid_model. JSON tidak valid atau field model tidak ada.Periksa payload dan nama model.
401invalid_api_key. Key tidak valid, sudah di-revoke, atau kedaluwarsa.Periksa key, atau buka lagi dari dashboard.
402quota_exhausted. Saldo token habis dan tidak ada paket lain yang aktif.Beli paket untuk melanjutkan.
403model_not_allowed, atau key_too_many_locations.Periksa daftar model paketmu, atau hentikan pemakaian key dari terlalu banyak perangkat.
429rate_limited atau concurrency_limited. Batas RPM atau request paralel tercapai.Tunggu sebentar lalu ulangi, hormati Retry-After.
502upstream_unavailable atau upstream_error. Penyedia tidak terjangkau atau membalas error tak terduga.Coba lagi sebentar. Detail internal tidak pernah dibuka.
503gateway_busy atau maintenance. Batas global penuh, atau sedang pemeliharaan.Coba lagi sebentar. Pengumuman lewat Telegram.

429 berarti kamu kena batasmu sendiri. 503 berarti penyedia atau gateway sedang bermasalah saat ini. Keduanya berbeda, dan penanganannya juga berbeda.

Satu-satunya pesan yang kamu terima saat terjadi gangguan di sisi OAO adalah pesan publik singkat beserta request_id:

json
{
  "error": {
    "code": "upstream_error",
    "message": "Upstream request failed.",
    "request_id": "req_20261103_ab12cd"
  }
}

Tunggu sebentar lalu ulangi. Kalau berlanjut, kirim request_id ke support di Telegram untuk penelusuran cepat.

Ulangi 429 dan 503 dengan backoff eksponensial, dan selalu hormati header Retry-After bila ada. Jangan ulangi 400, 401, 402 atau 403, karena request-nya akan gagal dengan cara yang sama setiap kali.

Untuk pertanyaan yang paling sering masuk: FAQ