Untuk agen AI: panduan pengaturan langkah demi langkah — /docs/agents.md, indeks dokumentasi — /llms.txt.
Tarif dan akun
Harga model, biaya deposit dan penarikan, kurs GNK. API akun berdasarkan kunci: saldo, pengeluaran per hari dan per model, riwayat transaksi, dan top up.
Harga model#
Harga sudah termasuk markup platform 10%. Nilai terkini ada di GET /api/pricing, tanpa kunci.
model | Input, $ per 1M token | Output, $ per 1M token | nGNK per token: input / output |
|---|---|---|---|
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 |
- Biaya permintaan = token input × harga input + token output × harga output. Penalaran model dihitung sebagai token output.
- Penagihan dalam GNK (1 GNK = 10⁹
nGNK); harga dalam dolar mengikuti kurs GNK $0.253. - Sebelum permintaan, gateway mencocokkan saldo dengan estimasi biaya; jika kurang —
402 insufficient_funds. - Setelah mendaftar, 0.1 GNK masuk ke akun — sekitar 3M token dengan harga input.
Komisi#
| Operasi | Komisi | Catatan |
|---|---|---|
| Markup untuk permintaan ke model | 10% | Sudah termasuk dalam harga di atas. |
| Isi ulang GNK | gratis | Transfer ke alamat gateway dengan memo Anda; kredit otomatis. |
| Isi ulang USDT | 5% → 2.5% | Pembayaran via OxaPay; semakin besar jumlahnya, semakin rendah komisinya — Tangga komisi USDT. |
| Isi ulang WGNK dari Ethereum | 1% | Menutupi gas jaringan Ethereum saat transfer ke Gonka. |
| Penarikan GNK | 5% | Hanya dari dashboard, mulai dari 1 GNK. |
| Kurs GNK | $0.253 | Dipakai untuk menghitung isi ulang dan harga dalam dolar; diperbarui otomatis. |
Tangga komisi USDT#
Tarif bergantung pada jumlah isi ulang, ambang batas inklusif:
| Jumlah isi ulang | Komisi |
|---|---|
| mulai dari $0 | 5% |
| mulai dari $25 | 4.5% |
| mulai dari $50 | 4% |
| mulai dari $100 | 3.5% |
| mulai dari $250 | 3% |
| mulai dari $500 | 2.75% |
| mulai dari $1000 | 2.5% |
API akun#
Saldo, pengeluaran, dan isi ulang dapat diakses dengan kunci yang sama seperti permintaan ke model (Authorization: Bearer jg-…). Permintaan ini tidak menghabiskan token.
Error: tanpa kunci — 401 authentication_error, parameter tidak valid — 400 validation_error, rute dashboard dengan kunci API — 403 forbidden.
GET /api/balance#
Saldo saat ini.
| Field | Deskripsi |
|---|---|
balance_ngonka | Saldo dalam nGNK — sebagai string agar presisi tidak hilang |
balance_usd | Saldo dalam dolar menurut kurs saat ini |
cost_per_token_ngonka | Harga token input model rekomendasi dengan markup, nGNK |
tokens_remaining | Berapa banyak token masukan yang bisa ditanggung saldo pada harga ini — perkiraan |
curl -s https://gate.joingonka.ai/api/balance \
-H "Authorization: Bearer $JOINGONKA_API_KEY"GET /api/usage#
Pemakaian per hari: permintaan, token, biaya.
period—day,week,month,quarter, defaultmonth.- Atau
fromdantodalam formatYYYY-MM-DD, keduanya sekaligus, hingga 92 hari inklusif — maka responsnya berisiperiod: custom. tz— offset dalam menit, sepertigetTimezoneOffset()di browser: untuk UTC+3 —-180. Tanpa ini — UTC.
Respons berupa array hari dengan field date, requests, tokens, costNgonka. Catatan rinci permintaan disimpan 90 hari.
curl -s "https://gate.joingonka.ai/api/usage?period=week&tz=-180" \
-H "Authorization: Bearer $JOINGONKA_API_KEY"GET /api/usage/by-model#
Pemakaian per model: total di models dan deret «periode × model» di series — jam jika period=day, selain itu hari. Parameter sama seperti /api/usage.
GET /api/usage/by-key#
Pemakaian per kunci — keys. Parameter sama seperti /api/usage.
GET /api/transactions#
Riwayat transaksi: top up, pemotongan untuk permintaan, bonus, penarikan.
limit— hingga 200, default 50;offset— pergeseran.type— filter:DEPOSIT_USDT,DEPOSIT_GNK,DEPOSIT_FIAT,INFERENCE,REFERRAL_REWARD,BONUS,WITHDRAWAL.fromdanto— tanggal, akhir inklusif.
Respons berisi catatan dengan field id, type, amountNgonka, feeNgonka, description, createdAt dan jumlah total total. Catatan INFERENCE yang lebih lama dari 90 hari diringkas menjadi satu per hari.
GET /api/deposits#
Hanya top up. Parameter limit, offset, from dan to — sama seperti riwayat transaksi; responsnya berisi total.
POST /api/deposit/gnk#
Detail top up GNK: address dan memo. Kirim GNK ke alamat ini dengan memo tersebut — saldo masuk otomatis.
GET /api/deposit/usdt/rate#
Kurs dan biaya top up USDT: gnk_usd_price, fee_percent, fee_tiers.
POST /api/deposit/usdt#
Tagihan pembayaran dalam USDT: body {"amount": 25} — jumlah dalam dolar dari 1 hingga 10000; responsnya berisi payment_url. Jika penerimaan USDT sementara ditutup — 503.
GET /api/pricing#
Harga dan biaya tanpa kunci: models[], deposit_usdt_fee_tiers, kurs GNK, dan bonus saat mendaftar.
Hanya di dasbor#
Pengelolaan akun ada di dasbor gate.joingonka.ai/dashboard. Rute ini bukan untuk integrasi, sebagian merespons kunci API 403 forbidden:
- kunci API — gate.joingonka.ai/keys;
- penarikan GNK — mulai dari 1 GNK;
- top up via kartu dan alamat pengirim WGNK;
- kode promo;
- program referal dan pengaturan pengiriman.