GeraikitaGeraikita AI
MenuSaldo e chaves de clientes

Saldo e chaves de clientes

Consulte o saldo pela API ou Telegram e entregue chaves de API com limite aos clientes.

Consultar saldo via API e Telegram

GET/v1/balance

Chame GET /v1/balance com a mesma chave de API (header Authorization: Bearer gk-… ou x-api-key). Grátis, não consome GeraiPoints, até 30 chamadas por minuto por chave.

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

A resposta traz o saldo da conta (só chaves pessoais), o uso da chave hoje/neste mês/total e o limite restante, se houver. Uma chave de cliente só vê os próprios dados — o saldo do dono nunca é exibido (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"
}

Pelo Telegram: vincule sua conta no painel (cartão Telegram → Conectar) e envie /saldo ao nosso bot oficial. Sem código: abra a página de saldo.

Chaves de clientes (para revendedores)

Quer vender acesso à IA sem que seus clientes criem conta ou recarreguem? Crie chaves de clientes em Painel → Chaves de clientes: uma chave de API por cliente, cada uma com limite de GP (único, diário ou mensal), modelos permitidos, pausa, e uso e exportação CSV separados. Tudo é cobrado do seu saldo a preço público.

Os limites valem antes do processamento: uma requisição que ultrapassaria o limite restante é recusada. Limite único esgotado → 402 KEY_BATAS_HABIS (aumente o limite para adicionar cota); limite diário/mensal atingido → 429 KEY_BATAS_HARIAN / KEY_BATAS_BULANAN com Retry-After. Chave pausada → 403 KEY_DIJEDA. Modelos -unli e bansos não funcionam com chaves de clientes.

Diferença em relação ao Programa de revendedores: ele dá preço com desconto para seu próprio servidor (exige site, lista de IPs permitidos, verificação de identidade e o header X-Customer-Ref). Chaves de clientes não têm esses requisitos e vão direto para os clientes, mas usam preço público.