GeraikitaGeraikita AI
菜单余额与客户密钥

余额与客户密钥

通过 API 或 Telegram 查询余额，并向客户发放有限额的 API 密钥。

通过 API 和 Telegram 查询余额

GET/v1/balance

使用同一个 API 密钥调用 GET /v1/balance（请求头 Authorization: Bearer gk-… 或 x-api-key）。免费，不消耗 GeraiPoints，每个密钥每分钟最多 30 次。

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

响应包含账户余额（仅个人密钥）、该密钥今日/本月/累计用量，以及设置了限额时的剩余限额。客户密钥只能看到自己的数据——所有者余额永不显示（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"
}

通过 Telegram：在控制台绑定账户（Telegram 卡片 → 连接），然后向官方机器人发送 /saldo。无需代码：打开余额查询页。

客户密钥（面向经销商）

想销售 AI 访问权限，又不想让客户自己注册和充值？在控制台 → 客户密钥创建客户密钥：每位客户一个 API 密钥，各自有 GP 限额（一次性、每日或每月）、允许的模型、暂停开关，以及独立的用量与 CSV 导出。所有费用按公开价格从你的余额扣除。

限额在处理前生效：会超出剩余限额的请求将被拒绝。一次性限额用完 → 402 KEY_BATAS_HABIS（调高限额即可追加）；达到每日/每月限额 → 429 KEY_BATAS_HARIAN / KEY_BATAS_BULANAN，附带 Retry-After。密钥已暂停 → 403 KEY_DIJEDA。客户密钥不能使用 -unli 和 bansos 模型。

与经销商计划的区别：该计划为你自己的服务器提供折扣价（需要网站、IP 白名单、身份验证和 X-Customer-Ref 请求头）。客户密钥没有这些要求，可直接交给客户，但按公开价格计费。