Saldo i klucze klientów

Sprawdzanie salda przez API i Telegram#

Wywołaj GET /v1/balance tym samym kluczem API (nagłówek Authorization: Bearer gk-… lub x-api-key). Bezpłatnie, bez zużycia GeraiPoints, do 30 wywołań na minutę na klucz.

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

Odpowiedź zawiera saldo konta (tylko klucze osobiste), zużycie klucza dziś/w tym miesiącu/łącznie oraz pozostały limit, jeśli jest ustawiony. Klucz klienta widzi tylko własne dane – saldo właściciela nigdy nie jest pokazywane (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"
}

Klucze klientów (dla resellerów)#

Chcesz sprzedawać dostęp do AI bez zakładania kont i doładowań przez klientów? Utwórz klucze klientów w Panel → Klucze klientów: jeden klucz API na klienta, każdy z limitem GP (jednorazowym, dziennym lub miesięcznym), dozwolonymi modelami, pauzą oraz osobnym zużyciem i eksportem CSV. Wszystko pobierane jest z Twojego salda po cenach publicznych.

Limity działają przed przetworzeniem: żądanie, które przekroczyłoby pozostały limit, jest odrzucane. Limit jednorazowy wyczerpany → 402 KEY_BATAS_HABIS (zwiększ limit, aby dodać); limit dzienny/miesięczny osiągnięty → 429 KEY_BATAS_HARIAN / KEY_BATAS_BULANAN z nagłówkiem Retry-After. Wstrzymany klucz → 403 KEY_DIJEDA. Modeli -unli i bansos nie można używać z kluczami klientów.