Saldo & klantsleutels

Saldo controleren via API & Telegram#

Roep GET /v1/balance aan met dezelfde API-sleutel (header Authorization: Bearer gk-… of x-api-key). Gratis, kost geen GeraiPoints, tot 30 keer per minuut per sleutel.

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

Het antwoord bevat het accountsaldo (alleen persoonlijke sleutels), het verbruik van de sleutel vandaag/deze maand/totaal en de resterende limiet als die is ingesteld. Een klantsleutel ziet alleen zijn eigen gegevens – het saldo van de eigenaar wordt nooit getoond (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"
}

Klantsleutels (voor resellers)#

AI-toegang verkopen zonder dat klanten een account maken of opwaarderen? Maak klantsleutels via Dashboard → Klantsleutels: één API-sleutel per klant, elk met een GP-limiet (eenmalig, dagelijks of maandelijks), toegestane modellen, pauzeknop en apart verbruik & CSV-export. Alles wordt tegen publieke prijzen van jouw saldo afgeschreven.

Limieten gelden vóór verwerking: een verzoek dat de resterende limiet zou overschrijden, wordt geweigerd. Eenmalige limiet op → 402 KEY_BATAS_HABIS (verhoog de limiet om tegoed toe te voegen); dag-/maandlimiet bereikt → 429 KEY_BATAS_HARIAN / KEY_BATAS_BULANAN met Retry-After. Gepauzeerde sleutel → 403 KEY_DIJEDA. -unli- en bansos-modellen werken niet met klantsleutels.