Для ШІ-агентів: покрокова інструкція з налаштування — /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;
- промокоди;
- реферальна програма та налаштування розсилок.