> Для ШІ-агентів: покрокова інструкція з налаштування — [`/docs/agents.md`](https://gate.joingonka.ai/docs/agents.md), індекс документації — [`/llms.txt`](https://gate.joingonka.ai/llms.txt).

# Тарифи та акаунт

Ціни моделей, комісії поповнення та виведення, курс GNK. API акаунта за ключем: баланс, витрати за днями та моделями, історія операцій і поповнень.

## Ціни моделей

Ціни вже включають націнку платформи 10%. Живі значення — `GET /api/pricing`, без ключа.

| `model` | Вхід, $ за 1M токенів | Вихід, $ за 1M токенів | nGNK за токен: вхід / вихід |
| --- | ---: | ---: | ---: |
| `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 |

- Вартість запиту = вхідні токени × ціна входу + вихідні × ціна виходу. Міркування моделі рахуються як вихідні токени.
- Списання — у GNK (1 GNK = 10⁹ `nGNK`); ціни в доларах — за курсом GNK $0.253.
- Перед запитом шлюз звіряє баланс з оцінкою вартості; не вистачає — `402 insufficient_funds`.
- Після реєстрації на рахунок надходить 0.1 GNK — близько 3M токенів за ціною входу.

## Комісії

| Операція | Комісія | Примітка |
| --- | --- | --- |
| Націнка на запити до моделей | 10% | Уже включена в ціни вище. |
| Поповнення GNK | безкоштовно | Переказ на адресу шлюзу з вашим `memo`; зарахування автоматичне. |
| Поповнення USDT | 5% → 2.5% | Платіж через OxaPay; що більша сума, то нижча комісія — [Драбинка комісії USDT](https://gate.joingonka.ai/uk/docs/billing#usdt-tiers). |
| Поповнення WGNK з Ethereum | 1% | Покриває газ мережі Ethereum під час переказу в Gonka. |
| Виведення GNK | 5% | Лише з кабінету, від 1 GNK. |
| Курс GNK | $0.253 | За ним рахуються поповнення та ціни в доларах; оновлюється автоматично. |

### Драбинка комісії USDT

Ставка залежить від суми поповнення, поріг включно:

| Сума поповнення | Комісія |
| --- | ---: |
| від $0 | 5% |
| від $25 | 4.5% |
| від $50 | 4% |
| від $100 | 3.5% |
| від $250 | 3% |
| від $500 | 2.75% |
| від $1000 | 2.5% |

## API акаунта

Баланс, витрати та поповнення доступні за тим самим ключем, що й запити до моделей (`Authorization: Bearer jg-…`). Ці запити токени не витрачають.

Помилки: без ключа — `401 authentication_error`, невірні параметри — `400 validation_error`, кабінетний маршрут з API-ключем — `403 forbidden`.

### GET `/api/balance`

Поточний баланс.

| Поле | Опис |
| --- | --- |
| `balance_ngonka` | Баланс у nGNK — рядком, щоб не втрачати точність |
| `balance_usd` | Баланс у доларах за поточним курсом |
| `cost_per_token_ngonka` | Ціна вхідного токена рекомендованої моделі з націнкою, nGNK |
| `tokens_remaining` | На скільки вхідних токенів вистачить балансу за цією ціною — оцінка |

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

### GET `/api/usage`

Витрати за днями: запити, токени, вартість.

- `period` — `day`, `week`, `month`, `quarter`, типово `month`.
- Або `from` і `to` у форматі `YYYY-MM-DD`, обидва одразу, до 92 днів включно — тоді у відповіді `period: custom`.
- `tz` — зсув у хвилинах, як `getTimezoneOffset()` у браузері: для UTC+3 — `-180`. Без нього — UTC.

Відповідь — масив днів із полями `date, requests, tokens, costNgonka`. Детальні записи про запити зберігаються 90 днів.

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

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

Витрати за моделями: підсумки в `models` і ряд «період × модель» у `series` — години при `period=day`, інакше дні. Параметри — як у `/api/usage`.

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

Витрати за ключами — `keys`. Параметри — як у `/api/usage`.

### GET `/api/transactions`

Історія операцій: поповнення, списання за запити, бонуси, виводи.

- `limit` — до 200, типово 50; `offset` — зсув.
- `type` — фільтр: `DEPOSIT_USDT`, `DEPOSIT_GNK`, `DEPOSIT_FIAT`, `INFERENCE`, `REFERRAL_REWARD`, `BONUS`, `WITHDRAWAL`.
- `from` і `to` — дати, кінець включно.

Відповідь — записи з полями `id, type, amountNgonka, feeNgonka, description, createdAt` і загальна кількість `total`. Записи `INFERENCE` старші за 90 днів згортаються в один за день.

### GET `/api/deposits`

Лише поповнення. Параметри `limit`, `offset`, `from` і `to` — як в історії операцій; у відповіді є `total`.

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

Реквізити поповнення GNK: `address` і `memo`. Перекажіть GNK на цю адресу з цим `memo` — зарахування автоматичне.

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

Курс і комісія поповнення USDT: `gnk_usd_price`, `fee_percent`, `fee_tiers`.

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

Рахунок на оплату в USDT: тіло `{"amount": 25}` — сума в доларах від 1 до 10000; у відповіді `payment_url`. Якщо приймання USDT тимчасово закрито — `503`.

### GET `/api/pricing`

Ціни та комісії без ключа: `models[]`, `deposit_usdt_fee_tiers`, курс GNK і бонус при реєстрації.

### Лише в кабінеті

Керування акаунтом — у кабінеті [gate.joingonka.ai/dashboard](https://gate.joingonka.ai/dashboard). Ці маршрути не для інтеграцій, частина з них відповідає API-ключу `403 forbidden`:

- ключі API — [gate.joingonka.ai/keys](https://gate.joingonka.ai/keys);
- виведення GNK — від 1 GNK;
- поповнення карткою та адреси відправників WGNK;
- промокоди;
- реферальна програма та налаштування розсилок.