GeraikitaGeraikita AI
MenuSố dư & khóa khách hàng

Số dư & khóa khách hàng

Kiểm tra số dư qua API hoặc Telegram và cấp API key có giới hạn cho khách hàng.

Kiểm tra số dư qua API & Telegram

GET/v1/balance

Gọi GET /v1/balance bằng chính API key đó (header Authorization: Bearer gk-… hoặc x-api-key). Miễn phí, không tốn GeraiPoints, tối đa 30 lần mỗi phút mỗi key.

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

Phản hồi gồm số dư tài khoản (chỉ với key cá nhân), mức dùng của key hôm nay/tháng này/tổng và giới hạn còn lại nếu có. Khóa khách hàng chỉ thấy dữ liệu của chính nó — số dư chủ sở hữu không bao giờ hiển thị (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"
}

Qua Telegram: liên kết tài khoản trong bảng điều khiển (thẻ Telegram → Kết nối), rồi gửi /saldo cho bot chính thức. Không cần code: mở trang kiểm tra số dư.

Khóa khách hàng (cho đại lý)

Muốn bán quyền truy cập AI mà khách hàng không cần tạo tài khoản hay nạp tiền? Tạo khóa khách hàng tại Bảng điều khiển → Khóa khách hàng: mỗi khách một API key, mỗi key có giới hạn GP (một lần, theo ngày hoặc theo tháng), mô hình được phép, nút tạm dừng, cùng mức dùng và xuất CSV riêng. Mọi chi phí trừ vào số dư của bạn theo giá công khai.

Giới hạn được áp dụng trước khi xử lý: yêu cầu vượt quá phần còn lại sẽ bị từ chối. Hết giới hạn một lần → 402 KEY_BATAS_HABIS (tăng giới hạn để thêm hạn mức); chạm giới hạn ngày/tháng → 429 KEY_BATAS_HARIAN / KEY_BATAS_BULANAN kèm Retry-After. Key tạm dừng → 403 KEY_DIJEDA. Mô hình -unli và bansos không dùng được với khóa khách hàng.

Khác với Chương trình đại lý: chương trình đó cho giá chiết khấu với máy chủ của bạn (cần website, danh sách IP cho phép, xác minh danh tính và header X-Customer-Ref). Khóa khách hàng không cần các điều kiện đó và có thể giao thẳng cho khách, nhưng dùng giá công khai.