Guthaben & Kunden-Keys

Guthaben per API & Telegram prüfen#

Rufe GET /v1/balance mit demselben API-Key auf (Header Authorization: Bearer gk-… oder x-api-key). Kostenlos, verbraucht keine GeraiPoints, bis zu 30 Aufrufe pro Minute und Key.

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

Die Antwort enthält das Kontoguthaben (nur persönliche Keys), die Nutzung des Keys heute/diesen Monat/gesamt und das Restlimit, falls gesetzt. Ein Kunden-Key sieht nur seine eigenen Daten – das Guthaben des Besitzers wird nie angezeigt (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"
}

Kunden-Keys (für Reseller)#

KI-Zugang verkaufen, ohne dass Kunden ein Konto anlegen oder aufladen? Erstelle Kunden-Keys unter Dashboard → Kunden-Keys: ein API-Key pro Kunde, jeweils mit GP-Limit (einmalig, täglich oder monatlich), erlaubten Modellen, Pause-Schalter sowie getrennter Nutzung & CSV-Export. Abgerechnet wird zu öffentlichen Preisen von deinem Guthaben.

Limits greifen vor der Verarbeitung: Eine Anfrage, die das Restlimit überschreiten würde, wird abgelehnt. Einmal-Limit aufgebraucht → 402 KEY_BATAS_HABIS (Limit erhöhen, um aufzustocken); Tages-/Monatslimit erreicht → 429 KEY_BATAS_HARIAN / KEY_BATAS_BULANAN mit Retry-After. Pausierter Key → 403 KEY_DIJEDA. -unli- und Bansos-Modelle sind mit Kunden-Keys nicht nutzbar.