GeraikitaGeraikita AI
MenuSolde et clés clients

Solde et clés clients

Vérifie ton solde par API ou Telegram et remets des clés API limitées à tes clients.

Vérifier le solde via API et Telegram

GET/v1/balance

Appelle GET /v1/balance avec la même clé API (en-tête Authorization: Bearer gk-… ou x-api-key). Gratuit, sans GeraiPoints, jusqu’à 30 appels par minute et par clé.

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

La réponse contient le solde du compte (clés personnelles uniquement), l’usage de la clé aujourd’hui/ce mois-ci/au total et la limite restante si elle existe. Une clé client ne voit que ses propres données : le solde du propriétaire n’est jamais affiché (akun: null).

200 OK
{
  "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"
}

Par Telegram : lie ton compte dans le tableau de bord (carte Telegram → Connecter), puis envoie /saldo à notre bot officiel. Sans code : ouvre la page de solde.

Clés clients (pour revendeurs)

Tu veux vendre un accès IA sans que tes clients créent de compte ni rechargent ? Crée des clés clients dans Tableau de bord → Clés clients : une clé API par client, chacune avec une limite de GP (unique, quotidienne ou mensuelle), des modèles autorisés, une pause, ainsi qu’un usage et un export CSV séparés. Tout est facturé sur ton solde au prix public.

Les limites s’appliquent avant le traitement : une requête qui dépasserait la limite restante est refusée. Limite unique épuisée → 402 KEY_BATAS_HABIS (augmente la limite pour ajouter du quota) ; limite quotidienne/mensuelle atteinte → 429 KEY_BATAS_HARIAN / KEY_BATAS_BULANAN avec Retry-After. Clé en pause → 403 KEY_DIJEDA. Les modèles -unli et bansos ne sont pas utilisables avec les clés clients.

Différence avec le Programme revendeur : ce programme offre des prix réduits pour ton propre serveur (site, liste d’IP autorisées, vérification d’identité et en-tête X-Customer-Ref requis). Les clés clients n’ont pas ces exigences et se remettent directement aux clients, mais au prix public.