> Для ИИ-агентов: пошаговая инструкция по настройке — [`/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/ru/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;
- промокоды;
- реферальная программа и настройки рассылок.