> Untuk agen AI: panduan pengaturan langkah demi langkah — [`/docs/agents.md`](https://gate.joingonka.ai/docs/agents.md), indeks dokumentasi — [`/llms.txt`](https://gate.joingonka.ai/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](https://gate.joingonka.ai/id/docs/billing#usdt-tiers). |
| 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 |

```bash
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`, default `month`.
- Atau `from` dan `to` dalam format `YYYY-MM-DD`, keduanya sekaligus, hingga 92 hari inklusif — maka responsnya berisi `period: custom`.
- `tz` — offset dalam menit, seperti `getTimezoneOffset()` 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.

```bash
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`.
- `from` dan `to` — 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](https://gate.joingonka.ai/dashboard). Rute ini bukan untuk integrasi, sebagian merespons kunci API `403 forbidden`:

- kunci API — [gate.joingonka.ai/keys](https://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.