> Para sa mga AI agent: step-by-step na gabay sa setup — [`/docs/agents.md`](https://gate.joingonka.ai/docs/agents.md), index ng dokumentasyon — [`/llms.txt`](https://gate.joingonka.ai/llms.txt).

# Mga taripa at account

Mga presyo ng modelo, bayad sa deposito at withdrawal, GNK rate. Account API gamit ang key: balanse, gastos ayon sa araw at modelo, kasaysayan ng transaksyon, at mga top-up.

## Mga presyo ng modelo

Kasama na sa mga presyo ang markup ng platform na 10%. Ang live na halaga — `GET /api/pricing`, walang key.

| `model` | Input, $ kada 1M tokens | Output, $ kada 1M tokens | nGNK kada 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 |

- Gastos ng kahilingan = input tokens × presyo ng input + output × presyo ng output. Ang pag-iisip ng modelo ay binibilang bilang output tokens.
- Ang singil ay sa GNK (1 GNK = 10⁹ `nGNK`); ang mga presyo sa dolyar — ayon sa rate ng GNK na $0.253.
- Bago ang kahilingan, tinitingnan ng gateway ang balanse laban sa pagtatantya ng gastos; kung kulang — `402 insufficient_funds`.
- Pagkatapos ng pagpaparehistro, may pumapasok na 0.1 GNK sa account — mga 3M tokens sa presyo ng input.

## Mga komisyon

| Operasyon | Komisyon | Tandaan |
| --- | --- | --- |
| Markup sa mga kahilingan sa modelo | 10% | Kasama na sa mga presyo sa itaas. |
| Top-up ng GNK | libre | Paglipat sa address ng gateway kasama ang iyong `memo`; awtomatikong pag-kredito. |
| Top-up ng USDT | 5% → 2.5% | Bayad sa pamamagitan ng OxaPay; mas malaki ang halaga, mas mababa ang komisyon — [Hagdan ng komisyon ng USDT](https://gate.joingonka.ai/tl/docs/billing#usdt-tiers). |
| Top-up ng WGNK mula sa Ethereum | 1% | Sinasaklaw ang gas ng Ethereum network kapag naglilipat sa Gonka. |
| Pag-withdraw ng GNK | 5% | Mula sa dashboard lamang, mula 1 GNK. |
| Rate ng GNK | $0.253 | Dito kinakalkula ang mga top-up at presyo sa dolyar; awtomatikong nag-a-update. |

### Hagdan ng komisyon ng USDT

Ang rate ay depende sa halaga ng top-up, kasama ang threshold:

| Halaga ng top-up | Komisyon |
| --- | ---: |
| mula $0 | 5% |
| mula $25 | 4.5% |
| mula $50 | 4% |
| mula $100 | 3.5% |
| mula $250 | 3% |
| mula $500 | 2.75% |
| mula $1000 | 2.5% |

## API ng account

Ang balanse, gastos at top-up ay available gamit ang parehong key na ginagamit sa mga kahilingan sa modelo (`Authorization: Bearer jg-…`). Ang mga kahilingang ito ay hindi gumagastos ng tokens.

Mga error: walang key — `401 authentication_error`, maling parameter — `400 validation_error`, dashboard route na may API key — `403 forbidden`.

### GET `/api/balance`

Kasalukuyang balanse.

| Field | Paglalarawan |
| --- | --- |
| `balance_ngonka` | Balanse sa nGNK — bilang string, para hindi mawala ang precision |
| `balance_usd` | Balanse sa dolyar ayon sa kasalukuyang rate |
| `cost_per_token_ngonka` | Presyo ng input token ng inirerekomendang modelo na may markup, nGNK |
| `tokens_remaining` | Gaano karaming input token ang kayang bayaran ng balanse sa presyong ito — tantya |

```bash
curl -s https://gate.joingonka.ai/api/balance \
  -H "Authorization: Bearer $JOINGONKA_API_KEY"
```

### GET `/api/usage`

Gastos kada araw: mga request, token, gastos.

- `period` — `day`, `week`, `month`, `quarter`, default ay `month`.
- O kaya `from` at `to` sa format na `YYYY-MM-DD`, pareho nang sabay, hanggang 92 araw kasama — kung gayon, sa sagot ay `period: custom`.
- `tz` — offset sa minuto, tulad ng `getTimezoneOffset()` sa browser: para sa UTC+3 — `-180`. Kung wala ito — UTC.

Ang sagot ay array ng mga araw na may mga field na `date, requests, tokens, costNgonka`. Ang detalyadong talaan ng mga request ay iniimbak nang 90 araw.

```bash
curl -s "https://gate.joingonka.ai/api/usage?period=week&tz=-180" \
  -H "Authorization: Bearer $JOINGONKA_API_KEY"
```

### GET `/api/usage/by-model`

Gastos kada modelo: mga kabuuan sa `models` at seryeng «panahon × modelo» sa `series` — oras kapag `period=day`, kung hindi ay araw. Mga parameter — tulad ng sa `/api/usage`.

### GET `/api/usage/by-key`

Gastos kada key — `keys`. Mga parameter — tulad ng sa `/api/usage`.

### GET `/api/transactions`

Kasaysayan ng mga operasyon: mga deposito, singil para sa mga request, bonus, pag-withdraw.

- `limit` — hanggang 200, default ay 50; `offset` — shift.
- `type` — filter: `DEPOSIT_USDT`, `DEPOSIT_GNK`, `DEPOSIT_FIAT`, `INFERENCE`, `REFERRAL_REWARD`, `BONUS`, `WITHDRAWAL`.
- `from` at `to` — mga petsa, kasama ang dulo.

Ang sagot ay mga talaan na may mga field na `id, type, amountNgonka, feeNgonka, description, createdAt` at kabuuang bilang na `total`. Ang mga talaan ng `INFERENCE` na mas luma sa 90 araw ay pinagsasama-sama sa isa kada araw.

### GET `/api/deposits`

Mga deposito lamang. Mga parameter na `limit`, `offset`, `from` at `to` — tulad ng sa kasaysayan ng mga operasyon; may `total` sa sagot.

### POST `/api/deposit/gnk`

Mga detalye ng deposito ng GNK: `address` at `memo`. Magpadala ng GNK sa address na ito kasama ang `memo` — awtomatiko ang pag-kredito.

### GET `/api/deposit/usdt/rate`

Rate at komisyon ng deposito ng USDT: `gnk_usd_price`, `fee_percent`, `fee_tiers`.

### POST `/api/deposit/usdt`

Invoice para sa pagbabayad sa USDT: katawan `{"amount": 25}` — halaga sa dolyar mula 1 hanggang 10000; sa sagot ay `payment_url`. Kung pansamantalang sarado ang pagtanggap ng USDT — `503`.

### GET `/api/pricing`

Mga presyo at komisyon nang walang key: `models[]`, `deposit_usdt_fee_tiers`, rate ng GNK at bonus sa pagpaparehistro.

### Sa cabinet lamang

Ang pamamahala ng account ay nasa cabinet na [gate.joingonka.ai/dashboard](https://gate.joingonka.ai/dashboard). Ang mga rutang ito ay hindi para sa mga integrasyon, ang ilan sa kanila ay tumutugon sa API key na `403 forbidden`:

- mga API key — [gate.joingonka.ai/keys](https://gate.joingonka.ai/keys);
- pag-withdraw ng GNK — mula 1 GNK;
- pagdeposito gamit ang card at mga address ng nagpadala ng WGNK;
- mga promo code;
- referral program at mga setting ng newsletter.