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 paket | RPM / key | Konkurensi / key | Batas context |
|---|---|---|---|
| VIP | 60–140 | 5–30 | 524K |
| Unlimited (reguler) | 30 | 3 | 256K |
| Token | 60 | 5 | tanpa 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.
| Status | Arti | Yang harus dilakukan |
|---|---|---|
400 | invalid_body atau invalid_model. JSON tidak valid atau field model tidak ada. | Periksa payload dan nama model. |
401 | invalid_api_key. Key tidak valid, sudah di-revoke, atau kedaluwarsa. | Periksa key, atau buka lagi dari dashboard. |
402 | quota_exhausted. Saldo token habis dan tidak ada paket lain yang aktif. | Beli paket untuk melanjutkan. |
403 | model_not_allowed, atau key_too_many_locations. | Periksa daftar model paketmu, atau hentikan pemakaian key dari terlalu banyak perangkat. |
429 | rate_limited atau concurrency_limited. Batas RPM atau request paralel tercapai. | Tunggu sebentar lalu ulangi, hormati Retry-After. |
502 | upstream_unavailable atau upstream_error. Penyedia tidak terjangkau atau membalas error tak terduga. | Coba lagi sebentar. Detail internal tidak pernah dibuka. |
503 | gateway_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:
{
"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

