Balance & customer keys

Check balance via API & Telegram#

Call GET /v1/balance with the same API key (header Authorization: Bearer gk-… or x-api-key). Free, uses no GeraiPoints, up to 30 calls per minute per key.

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

The response contains the account balance (personal keys only), the key's usage today/this month/total, and the remaining limit if the key has one. A customer key only sees its own data — the owner's balance is never shown (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"
}

Customer keys (for resellers)#

Want to sell AI access without your customers creating an account or topping up? Create customer keys in Dashboard → Customer keys: one API key per customer, each with a GP limit (one-time, daily or monthly), allowed models, a pause switch, and separate usage & CSV export. Everything is billed to your balance at public prices.

Limits are enforced before a request is processed: a request that would exceed the remaining limit is rejected. One-time limit used up → 402 KEY_BATAS_HABIS (raise the limit to add quota); daily/monthly limit reached → 429 KEY_BATAS_HARIAN / KEY_BATAS_BULANAN with a Retry-After header. Paused key → 403 KEY_DIJEDA. -unli and bansos models cannot be used with customer keys.