Status key & batas pemakaian

Panggil GET https://router.rnevio.com/v1/key menggunakan API key Anda. Pemeriksaan ini tidak menjalankan model dan tidak memotong token.

curl https://router.rnevio.com/v1/key \
  -H "Authorization: Bearer $RNEVIO_API_KEY"

Respons berisi data.status, token_balance, unit: "tokens", billing_mode: "token_package", rate_limits, model_access, allowed_models, last_metered_at, dan checked_at. rate_limits[].window_seconds menggunakan detik. Saldo dalam token, bukan Rupiah atau USD. Batas key berlaku per key; semua key customer memakai jatah akun yang sama.

Key yang kehabisan token tetap dapat memeriksa saldo. status: "insufficient_quota" berarti isi ulang atau tunggu jendela refresh paket; tidak perlu membuat ulang key. Key yang tidak valid atau sudah dicabut mendapat 401. Bila sumber data tidak tersedia, endpoint mengembalikan 503 dan Retry-After, bukan saldo nol palsu.

Metering berjalan berkala. last_metered_at menunjukkan waktu request terakhir yang sudah diselesaikan pencatatannya, bukan waktu server terakhir diperiksa. Request yang masih berjalan atau baru selesai mungkin belum masuk saldo. Batasi pemeriksaan aplikasi, misalnya sekali per 30–60 detik; jangan memanggilnya untuk setiap potongan streaming.

Untuk inferensi, 402 berarti kuota token habis, 403 berarti akses dibatasi, 429 berarti batas request atau kuota provider, dan 5xx berarti gangguan layanan/upstream. Ikuti Retry-After bila tersedia. Hindari percobaan ulang otomatis setelah streaming sudah mengeluarkan konten karena dapat menggandakan hasil dan pemakaian.

Gunakan halaman Billing untuk rincian paket dan Logs untuk metadata request. Model dengan input gambar tidak selalu dapat menghasilkan gambar; gunakan kapabilitas di katalog dan dokumentasi model.