Для ИИ-агентов: пошаговая инструкция по настройке — /docs/agents.md, индекс документации — /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. |
| Пополнение 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 | На сколько входных токенов хватит баланса по этой цене — оценка |
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 дней.
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. Эти маршруты не для интеграций, часть из них отвечает API-ключу 403 forbidden:
- ключи API — gate.joingonka.ai/keys;
- вывод GNK — от 1 GNK;
- пополнение картой и адреса отправителей WGNK;
- промокоды;
- реферальная программа и настройки рассылок.