Saldo y claves de clientes

Consultar saldo por API y Telegram#

Llama a GET /v1/balance con la misma API key (header Authorization: Bearer gk-… o x-api-key). Gratis, no consume GeraiPoints, hasta 30 llamadas por minuto por clave.

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

La respuesta incluye el saldo de la cuenta (solo claves personales), el uso de la clave hoy/este mes/total y el límite restante si lo tiene. Una clave de cliente solo ve sus propios datos: el saldo del propietario nunca se muestra (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"
}

Claves de clientes (para revendedores)#

¿Quieres vender acceso a IA sin que tus clientes creen cuenta ni recarguen? Crea claves de cliente en Panel → Claves de clientes: una API key por cliente, cada una con límite de GP (única vez, diario o mensual), modelos permitidos, pausa, y uso y exportación CSV por separado. Todo se cobra de tu saldo a precio público.

Los límites se aplican antes de procesar: una solicitud que superaría el límite restante se rechaza. Límite único agotado → 402 KEY_BATAS_HABIS (sube el límite para añadir cuota); límite diario/mensual alcanzado → 429 KEY_BATAS_HARIAN / KEY_BATAS_BULANAN con Retry-After. Clave pausada → 403 KEY_DIJEDA. Los modelos -unli y bansos no se pueden usar con claves de cliente.