Баланс и ключи клиентов

Проверка баланса через API и Telegram#

Вызовите GET /v1/balance с тем же API-ключом (заголовок Authorization: Bearer gk-… или x-api-key). Бесплатно, GeraiPoints не тратятся, до 30 вызовов в минуту на ключ.

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

Ответ содержит баланс аккаунта (только для личных ключей), расход ключа за сегодня/месяц/всего и остаток лимита, если он задан. Ключ клиента видит только свои данные — баланс владельца никогда не показывается (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"
}

Ключи клиентов (для реселлеров)#

Хотите продавать доступ к ИИ без регистрации и пополнений со стороны клиентов? Создайте ключи клиентов в Панель → Ключи клиентов: по одному API-ключу на клиента, у каждого лимит GP (разовый, дневной или месячный), разрешённые модели, пауза, отдельный расход и экспорт CSV. Всё списывается с вашего баланса по публичным ценам.

Лимиты проверяются до обработки: запрос, который превысил бы остаток, отклоняется. Разовый лимит исчерпан → 402 KEY_BATAS_HABIS (увеличьте лимит, чтобы добавить объём); дневной/месячный лимит достигнут → 429 KEY_BATAS_HARIAN / KEY_BATAS_BULANAN с заголовком Retry-After. Ключ на паузе → 403 KEY_DIJEDA. Модели -unli и bansos недоступны по ключам клиентов.