Dành cho AI agent: hướng dẫn từng bước để thiết lập — /docs/agents.md, chỉ mục tài liệu — /llms.txt.
Bảng giá và tài khoản
Giá các mô hình, phí nạp và rút tiền, tỷ giá GNK. API tài khoản theo khóa: số dư, chi tiêu theo ngày và theo mô hình, lịch sử giao dịch và nạp tiền.
Giá model#
Giá đã bao gồm mức chênh lệch của nền tảng 10%. Giá trị trực tiếp ở GET /api/pricing, không cần key.
model | Đầu vào, $ cho 1M token | Đầu ra, $ cho 1M token | nGNK mỗi token: đầu vào / đầu ra |
|---|---|---|---|
MiniMaxAI/MiniMax-M2.7 | $0.008349 | $0.02505 | 33 / 99 |
deepseek-ai/DeepSeek-V4-Flash-0731 | $0.008349 | $0.02505 | 33 / 99 |
zai-org/GLM-5.3-Flash | $0.008349 | $0.02505 | 33 / 99 |
- Chi phí yêu cầu = token đầu vào × giá đầu vào + token đầu ra × giá đầu ra. Phần suy luận của model được tính là token đầu ra.
- Trừ tiền bằng GNK (1 GNK = 10⁹
nGNK); giá bằng đô la tính theo tỷ giá GNK $0.253. - Trước mỗi yêu cầu, gateway đối chiếu số dư với ước tính chi phí; không đủ thì trả
402 insufficient_funds. - Sau khi đăng ký, tài khoản nhận 0.1 GNK — khoảng 3M token theo giá đầu vào.
Phí#
| Thao tác | Phí | Ghi chú |
|---|---|---|
| Mức chênh lệch cho yêu cầu gọi model | 10% | Đã bao gồm trong giá ở trên. |
| Nạp GNK | miễn phí | Chuyển đến địa chỉ gateway kèm memo của bạn; ghi có tự động. |
| Nạp USDT | 5% → 2.5% | Thanh toán qua OxaPay; số tiền càng lớn, phí càng thấp — Bậc phí USDT. |
| Nạp WGNK từ Ethereum | 1% | Trang trải phí gas của mạng Ethereum khi chuyển sang Gonka. |
| Rút GNK | 5% | Chỉ từ trang quản lý, tối thiểu 1 GNK. |
| Tỷ giá GNK | $0.253 | Dùng để tính tiền nạp và giá bằng đô la; tự động cập nhật. |
Bậc phí USDT#
Mức phí phụ thuộc số tiền nạp, ngưỡng tính bao gồm:
| Số tiền nạp | Phí |
|---|---|
| từ $0 | 5% |
| từ $25 | 4.5% |
| từ $50 | 4% |
| từ $100 | 3.5% |
| từ $250 | 3% |
| từ $500 | 2.75% |
| từ $1000 | 2.5% |
API tài khoản#
Số dư, chi tiêu và tiền nạp đều truy cập được bằng chính key dùng để gọi model (Authorization: Bearer jg-…). Những yêu cầu này không tốn token.
Lỗi: không có key — 401 authentication_error, tham số sai — 400 validation_error, route dành cho trang quản lý mà dùng API key — 403 forbidden.
GET /api/balance#
Số dư hiện tại.
| Trường | Mô tả |
|---|---|
balance_ngonka | Số dư bằng nGNK — dạng chuỗi để không mất độ chính xác |
balance_usd | Số dư bằng đô la theo tỷ giá hiện tại |
cost_per_token_ngonka | Giá token đầu vào của model được đề xuất kèm mức chênh lệch, nGNK |
tokens_remaining | Số token đầu vào mà số dư đủ dùng ở mức giá này — ước tính |
curl -s https://gate.joingonka.ai/api/balance \
-H "Authorization: Bearer $JOINGONKA_API_KEY"GET /api/usage#
Chi tiêu theo ngày: yêu cầu, token, chi phí.
period—day,week,month,quarter, mặc định làmonth.- Hoặc
fromvàtotheo định dạngYYYY-MM-DD, cả hai cùng lúc, tối đa 92 ngày — khi đó phản hồi trả vềperiod: custom. tz— độ lệch tính bằng phút, giốnggetTimezoneOffset()trên trình duyệt: với UTC+3 là-180. Không có thì mặc định là UTC.
Phản hồi là một mảng các ngày với các trường date, requests, tokens, costNgonka. Bản ghi chi tiết về yêu cầu được lưu trong 90 ngày.
curl -s "https://gate.joingonka.ai/api/usage?period=week&tz=-180" \
-H "Authorization: Bearer $JOINGONKA_API_KEY"GET /api/usage/by-model#
Chi tiêu theo model: tổng hợp trong models và chuỗi «khoảng thời gian × model» trong series — theo giờ khi period=day, ngược lại theo ngày. Tham số giống như /api/usage.
GET /api/usage/by-key#
Chi tiêu theo key — keys. Tham số giống như /api/usage.
GET /api/transactions#
Lịch sử giao dịch: nạp tiền, trừ tiền cho yêu cầu, tiền thưởng, rút tiền.
limit— tối đa 200, mặc định là 50;offset— độ dịch.type— bộ lọc:DEPOSIT_USDT,DEPOSIT_GNK,DEPOSIT_FIAT,INFERENCE,REFERRAL_REWARD,BONUS,WITHDRAWAL.fromvàto— ngày, bao gồm ngày kết thúc.
Phản hồi là các bản ghi với các trường id, type, amountNgonka, feeNgonka, description, createdAt và tổng số total. Các bản ghi INFERENCE cũ hơn 90 ngày sẽ được gộp thành một bản ghi mỗi ngày.
GET /api/deposits#
Chỉ nạp tiền. Tham số limit, offset, from và to giống như lịch sử giao dịch; trong phản hồi có total.
POST /api/deposit/gnk#
Thông tin nạp GNK: address và memo. Chuyển GNK đến địa chỉ này kèm memo — tiền sẽ được ghi có tự động.
GET /api/deposit/usdt/rate#
Tỷ giá và phí nạp USDT: gnk_usd_price, fee_percent, fee_tiers.
POST /api/deposit/usdt#
Hóa đơn thanh toán bằng USDT: nội dung {"amount": 25} — số tiền bằng đô la từ 1 đến 10000; phản hồi trả về payment_url. Nếu tạm thời đóng nhận USDT — 503.
GET /api/pricing#
Giá và phí không cần key: models[], deposit_usdt_fee_tiers, tỷ giá GNK và tiền thưởng khi đăng ký.
Chỉ trong trang cá nhân#
Quản lý tài khoản nằm trong trang cá nhân gate.joingonka.ai/dashboard. Những route này không dành cho tích hợp, một số trong đó phản hồi API key 403 forbidden:
- API key — gate.joingonka.ai/keys;
- rút GNK — từ 1 GNK;
- nạp bằng thẻ và địa chỉ người gửi WGNK;
- mã khuyến mãi;
- chương trình giới thiệu và cài đặt gửi thông báo.