Referensi
Kode error
Semua error memakai amplop yang sama dan selalu menyertakan request_id, baik di body maupun di header X-Request-Id.
| Kode | HTTP | Penyebab | Tindakan |
|---|---|---|---|
| VALIDATION_ERROR | 400 | Payload gagal validasi skema. | Periksa field pada details respons. |
| INVALID_API_KEY | 401 | Header Bearer hilang, salah format, atau hash tidak ditemukan. | Pastikan key dikirim penuh dan belum dihapus. |
| KEY_REVOKED | 401 | Key sudah dicabut permanen. | Terbitkan key baru dari panel. |
| KEY_EXPIRED | 401 | Tanggal expiry key sudah lewat. | Rotasi key atau buat key baru. |
| KEY_DISABLED | 401 | Key dinonaktifkan sementara oleh pemilik. | Aktifkan kembali dari halaman API Key. |
| SCOPE_NOT_ALLOWED | 403 | Scope key tidak mengizinkan endpoint ini. | Tambahkan scope chat.completions atau models.read. |
| IP_NOT_ALLOWED | 403 | IP pemanggil di luar allowlist key. | Perbarui daftar CIDR pada key. |
| ACCOUNT_SUSPENDED | 403 | Akun ditangguhkan operator. | Hubungi dukungan. |
| INSUFFICIENT_CREDIT | 402 | Saldo tidak cukup untuk estimasi biaya request. | Ajukan top-up manual di halaman Credit. |
| RATE_LIMITED | 429 | Batas RPM atau batas harian terlampaui. | Ikuti header Retry-After sebelum mencoba lagi. |
| MODEL_NOT_FOUND | 404 | Slug model tidak ada atau tidak aktif. | Ambil daftar dari GET /v1/models. |
| MAINTENANCE_MODE | 503 | Operator mengaktifkan maintenance mode. | Pantau halaman /status. |
| UPSTREAM_ERROR | 502 | Seluruh provider kandidat gagal atau timeout. | Coba lagi; router sudah melakukan failover otomatis. |
| CSRF_INVALID | 403 | Token CSRF hilang atau tidak cocok pada endpoint panel. | Endpoint /v1 tidak butuh CSRF; gunakan Bearer key. |
| INTERNAL_ERROR | 500 | Kesalahan tidak terduga di sisi server. | Laporkan request_id dari respons. |