Saldo e chiavi clienti

Verifica saldo via API e Telegram#

Chiama GET /v1/balance con la stessa chiave API (header Authorization: Bearer gk-… o x-api-key). Gratis, non consuma GeraiPoints, fino a 30 chiamate al minuto per chiave.

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

La risposta contiene il saldo dell’account (solo chiavi personali), l’utilizzo della chiave oggi/questo mese/in totale e il limite residuo se impostato. Una chiave cliente vede solo i propri dati: il saldo del proprietario non viene mai mostrato (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"
}

Chiavi clienti (per rivenditori)#

Vuoi vendere accesso all’IA senza che i clienti creino un account o ricarichino? Crea chiavi clienti in Dashboard → Chiavi clienti: una chiave API per cliente, ciascuna con limite GP (una tantum, giornaliero o mensile), modelli consentiti, pausa, e utilizzo ed esportazione CSV separati. Tutto viene addebitato sul tuo saldo a prezzo pubblico.

I limiti si applicano prima dell’elaborazione: una richiesta che supererebbe il limite residuo viene rifiutata. Limite una tantum esaurito → 402 KEY_BATAS_HABIS (aumenta il limite per aggiungere quota); limite giornaliero/mensile raggiunto → 429 KEY_BATAS_HARIAN / KEY_BATAS_BULANAN con Retry-After. Chiave in pausa → 403 KEY_DIJEDA. I modelli -unli e bansos non sono utilizzabili con le chiavi clienti.