Dokumentasi
Limit & Error
Rate limit
Ada batas request per menit yang wajar buat menjaga layanan tetap stabil untuk semua orang. Kalau kamu kena batas, API menjawab 429 — tunggu sebentar, lalu coba lagi.
Pola yang benar: retry dengan backoff — jeda makin lama di tiap percobaan (mis. 1 detik, 2 detik, 4 detik), maksimal beberapa kali, lalu berhenti dan laporkan. Jangan spam retry tiap 100ms; itu cuma bikin kamu kena limit lebih lama.
Kode error umum
| Kode | Arti | Yang harus kamu lakukan |
|---|---|---|
401 | API key salah atau tidak dikirim. | Cek header Authorization: Bearer PR-KEY — key lengkap, tanpa spasi berlebih. Kalau masih gagal, buat key baru dari bot (lihat API Key). |
403 | Model tidak aktif atau tidak tersedia untukmu. | Ganti ke model lain dari daftar aktif (GET /v1/models atau halaman Model). |
429 | Kena rate limit. | Tunggu, lalu retry dengan backoff seperti di atas. Kalau terus kena, kurangi laju request-mu. |
502 | Upstream (provider model) sedang bermasalah. | Coba lagi nanti, atau pindah ke model dari provider lain sementara. |
Masih error?
Catat kode error, model yang dipakai, dan waktu kejadian (WIB), lalu hubungi lewat halaman Kontak — pilih jenis “Masalah API”. Makin lengkap infonya, makin cepat dibantu.