Clouvia RouterRouter ClouviaID
DIAGNOSTIK & KODE STATUS

Kode Error & Solusi

Daftar lengkap kode error sistem, penyebab potensial, dan solusi praktis untuk menangani kesalahan pada gateway. Semua respons error dibungkus dalam amplop JSON terstandarisasi.

ERROR ENVELOPE:Standard RFC-7807
TRACKING ID:X-Request-Id (Ulid)
STATUS CODES:4xx Client / 5xx Server

Format Amplop JSON Respons Error

STANDARD PAYLOAD

Setiap kegagalan inferensi mengembalikan payload JSON terstruktur yang selalu memuat atribut code, deskripsi message manusiawi dalam bahasa yang jelas, serta request_id untuk keperluan audit:

Contoh Respons Error HTTP 402json
1{
2  "error": {
3    "code": "INSUFFICIENT_CREDIT",
4    "message": "Saldo token akun tidak mencukupi untuk request ini. Silakan top-up kuota token.",
5    "request_id": "01M2K5X1XN6R84VPVADSG0THDM",
6    "details": {
7      "current_balance": 0,
8      "minimum_required": 1000000
9    }
10  }
11}

Matriks Kode Error Gateway

Kode ErrorHTTPPenyebab MasalahTindakan Solusi
VALIDATION_ERROR400Payload JSON tidak sesuai skema (messages kosong, role salah, atau model tidak valid).Periksa field pada array messages dan pastikan model slug terdaftar di /v1/models.
INVALID_API_KEY401Header Authorization Bearer tidak disertakan, salah format, atau secret key salah.Pastikan header dikirim sebagai "Authorization: Bearer clv_live_..." tanpa spasi berlebih.
KEY_REVOKED401API Key telah dicabut (revoked) secara permanen dari panel client.Terbitkan API Key baru dari menu API Key di konsol client.
KEY_EXPIRED401Tanggal kedaluwarsa API Key telah terlewati sesuai batas waktu saat pembuatan.Lakukan rotasi key atau terbitkan key baru tanpa batasan masa berlaku.
KEY_DISABLED401Key dinonaktifkan sementara oleh pemilik akun dari tombol switch toggle status.Aktifkan kembali API Key tersebut dari panel manajemen API Key.
INSUFFICIENT_CREDIT402Saldo kuota token pada dompet akun Anda telah habis atau kurang dari estimasi biaya inferensi.Lakukan isi ulang saldo token via QRIS instan otomatis di halaman Token Saldo & Billing.
SCOPE_NOT_ALLOWED403API Key tidak memiliki izin scope yang dibutuhkan (misal: scope models.read untuk /v1/models).Edit konfigurasi API Key di panel untuk menambahkan scope yang sesuai.
IP_NOT_ALLOWED403Alamat IP server/laptop pemanggil tidak termasuk dalam daftar CIDR IP Allowlist key.Perbarui daftar CIDR pada konfigurasi key atau kosongkan agar dapat dipanggil dari semua IP.
ACCOUNT_SUSPENDED403Akun ditangguhkan oleh operator sistem karena indikasi penyalahgunaan atau pelanggaran TOS.Hubungi tim dukungan operator via WhatsApp atau Telegram resmi untuk klarifikasi.
RATE_LIMITED429Jumlah request per menit (RPM) atau batas kuota harian key telah terlampaui.Terapkan exponential backoff pada client Anda dan patuhi nilai header Retry-After.
UPSTREAM_OVERLOAD503Cluster provider model upstream sedang mengalami antrian padat.Gateway akan secara otomatis mencoba cluster failover sekunder. Coba kembali beberapa detik kemudian.

Audit Telemetri Menggunakan X-Request-Id

SUPPORT AUDIT

Jika Anda mengalami kendala yang memerlukan investigasi lanjutan dari tim teknis Clouvia Router, Anda cukup menyalin nilai header X-Request-Id yang diterima client Anda dan mengirimkannya kepada operator dukungan.

Hubungi Telegram Operator↗WhatsApp Bantuan 24/7