Cek saldo & kunci pelanggan

Cek saldo via API & Telegram#

Panggil GET /v1/balance dengan API key yang sama (header Authorization: Bearer gk-… atau x-api-key). Gratis, tidak memakai GeraiPoints, maksimal 30 kali per menit per key.

curl https://ai.geraikita.com/v1/balance \
  -H "Authorization: Bearer gk-xxxxxxxx"

Jawabannya berisi saldo akun (khusus key pribadi), pemakaian key hari ini/bulan ini/total, dan sisa batas bila key punya batas. Kunci pelanggan hanya melihat data key-nya sendiri — saldo pemilik tidak pernah ditampilkan (akun: null).

{
  "object": "balance",
  "satuan": "GP",
  "key": { "nama": "Toko Budi", "prefix": "gk-AbCdEfGh", "jenis": "pelanggan", "status": "aktif" },
  "batas": { "periode": "bulanan", "batas_gp": 50000, "terpakai_gp": 12500, "sisa_gp": 37500,
             "reset_at": "2026-11-30T17:00:00.000Z" },
  "pemakaian_key": { "hari_ini_gp": 800, "bulan_ini_gp": 12500, "total_gp": 40100,
                     "request_hari_ini": 14, "request_total": 702 },
  "akun": null,
  "bisa_dipakai": true,
  "diperbarui_at": "2026-11-05T03:12:09.000Z"
}

Kunci pelanggan (untuk reseller)#

Ingin menjual akses AI tanpa pelangganmu membuat akun atau top up sendiri? Buat kunci pelanggan di Dashboard → Kunci pelanggan: satu API key per pelanggan, masing-masing dengan batas GP (sekali, harian, atau bulanan), model yang diizinkan, tombol jeda, serta pemakaian & ekspor CSV terpisah. Semua tagihan diambil dari saldomu dengan harga publik.

Batas ditegakkan sebelum request diproses: request yang akan melewati sisa batas ditolak. Batas sekali habis → 402 KEY_BATAS_HABIS (naikkan batas untuk menambah kuota); batas harian/bulanan tercapai → 429 KEY_BATAS_HARIAN / KEY_BATAS_BULANAN dengan header Retry-After. Key dijeda → 403 KEY_DIJEDA. Model -unli dan bansos tidak bisa dipakai lewat kunci pelanggan.