JoinGonka Gateway — повний огляд

JoinGonka Gateway — це проміжний шар між вашим додатком та мережею Gonka. Архітектура:

1. Ваш додаток надсилає запит до gate.joingonka.ai/v1/chat/completions (OpenAI-формат) або gate.joingonka.ai/v1/messages (Anthropic-формат).
2. Gateway приймає запит у будь-якому з двох форматів, перевіряє API-ключ та баланс, і перенаправляє його до мережі Gonka.
3. Мережа Gonka обробляє запит на одній з ~582 ML-нод з моделлю Kimi K2.6.
4. Gateway отримує відповідь, рахує спожиті токени, списує баланс і повертає відповідь вашому додатку — у тому ж форматі, в якому був отриманий запит (OpenAI або Anthropic).

Два API-формати: Gateway підтримує як OpenAI Chat Completions API (/v1/chat/completions), так і Anthropic Messages API (/v1/messages). Це означає, що інструменти на кшталт Cursor та LangChain працюють через OpenAI-формат, а Claude Code підключається напряму через Anthropic-формат — без проксі та конвертерів.

Навіщо потрібен Gateway, якщо є прямий API Gonka? Прямий API Gonka вимагає крипто-гаманець, підписання транзакцій GNK та розуміння блокчейну. JoinGonka Gateway прибирає цю складність: ви платите в зручній валюті (GNK, USDT, фіат), отримуєте звичний OpenAI- або Anthropic-формат API, використовуєте Dashboard для моніторингу — без будь-яких знань про криптовалюти.

Технічний стек: Fastify (Node.js), PostgreSQL, nginx. Gateway обробляє до 1000 запитів/сек, підтримує streaming (SSE в обох форматах), tool calling та всі параметри OpenAI Chat Completions + Anthropic Messages API. Час додавання до латентності — менше 50мс.

Весь процес займає 2 хвилини:

1. Реєстрація: перейдіть на gate.joingonka.ai/register. Email + пароль — стандартна форма.
2. Бонус: при реєстрації автоматично нараховується 10 000 000 безкоштовних токенів. Цього вистачить на тисячі запитів до AI — достатньо для тестування та перших інтеграцій.
3. Створення ключа: у Dashboard → API Keys → Create Key. Ключ починається з jg-, наприклад jg-abc123def456. Відображається один раз — збережіть його.
4. Перший запит: використовуйте ключ у будь-якому OpenAI- або Anthropic-сумісному клієнті. Для OpenAI-формату замініть base_url на https://gate.joingonka.ai/v1. Для Anthropic-формату (Claude Code) — ANTHROPIC_BASE_URL=https://gate.joingonka.ai.

Готові інструкції для популярних інструментів: Cursor, Claude Code, Aider, Continue.dev, Cline, LangChain, n8n, Open WebUI, LibreChat. Приклади коду (curl, Python, TypeScript) — у API швидкому старті.

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

Ті ж відкриті моделі, які роздає децентралізована мережа Gonka, доступні й на звичайних inference-майданчиках — наприклад, на OpenRouter. Різниця в тому, скільки за них беруть. Порівняємо ціну за 1M токенів одних і тих самих моделей:

Та ж модель — у сотні разів дешевше. JoinGonka Gateway віддає MiniMax-M2.7 та Kimi-K2.6 за ~$0.003 на вході та ~$0.009 на виході за 1M токенів (вихід дорожчий утричі — як і в інших провайдерів). На звичайних майданчиках ті ж самі ваги моделі коштують у сотні разів дорожче: причина в архітектурі — у Gonka inference оплачується майнерами через Proof of Useful Work, а не маржею дата-центру.

Не тільки ціна. JoinGonka Gateway дає обидва формати API — OpenAI (/v1/chat/completions) та Anthropic (/v1/messages), тому Claude Code підключається напряму через нативний формат Anthropic. Плюс нативний tool calling, Dashboard з аналітикою, гнучка оплата (GNK 0%, USDT 5%, фіат) та реферальна програма (10% L1 + 3% L2).

Вісім ключових переваг:

1. Найдешевший OpenAI + Anthropic сумісний API: $0.003/1M токенів — у 930 разів дешевше за OpenAI GPT-5.5. Для більшості завдань різниця непомітна за якістю, але кардинальна за вартістю.
2. Два формати API — OpenAI та Anthropic: /v1/chat/completions (OpenAI) та /v1/messages (Anthropic) — обидва працюють з одним ключем. Cursor, LangChain, openai SDK — через OpenAI-формат. Claude Code — через Anthropic-формат, напряму, без проксі. Жоден конкурент цього не пропонує.
3. Нативний tool calling: Kimi K2.6 підтримує function calling в обох форматах — OpenAI та Anthropic. Агенти, ланцюжки, автоматизація — все працює надійно.
4. Безкоштовний старт: 10M токенів при реєстрації. Цього вистачить на тижні тестування та перші інтеграції — без оплати.
5. Гнучка оплата: GNK (0% комісія), USDT (5%), фіат через On-Ramp. Не потрібно розбиратися в криптовалютах — можна заплатити карткою.
6. Реферальна програма: 10% від витрат залучених користувачів (L1) + 3% від їхніх рефералів (L2). Діліться посиланням — заробляйте токени.
7. Dashboard та аналітика: повноцінна CRM — баланс, витрати, історія запитів, API-ключі. Все в одному інтерфейсі.
8. Повна сумісність з екосистемою: працює з будь-яким OpenAI-сумісним клієнтом (Cursor, n8n, LangChain) та Anthropic-сумісним клієнтом (Claude Code) — без модифікацій.

Білінг JoinGonka Gateway працює в токенах GNK (внутрішня одиниця):

• Поповнення GNK: 0% комісія. Ви надсилаєте GNK на адресу Gateway, баланс зараховується миттєво.
• Поповнення USDT: 5% комісія. Платите USDT (через OxaPay), Gateway конвертує в GNK автоматично. 5% — плата за зручність (не потрібен крипто-гаманець Gonka).
• Поповнення фіат: через On-Ramp (картка → USDT → GNK). Комісія залежить від провайдера On-Ramp.

Комісія платформи: до базової вартості inference в мережі Gonka застосовується комісія 10%. Ця комісія вже включена в підсумкову ціну ~$0.003/1M токенів. Базова вартість у мережі — ~$0.0027/1M, з комісією — ~$0.003/1M. Комісія покриває витрати на інфраструктуру Gateway (сервери, БД, моніторинг).

Як рахується витрата: кожен запит до API (як через OpenAI-формат, так і через Anthropic-формат) витрачає токени з єдиного балансу. Gateway рахує prompt_tokens (вхідні) + completion_tokens (вихідні) та списує з балансу. Вартість: $0.003 за 1M токенів (~0.003 GNK за поточним курсом). Один ключ, один баланс — для обох API-форматів.

Tool calling: виклики функцій (tools) теж витрачають токени — визначення функцій додаються до промпту. Типовий tool calling запит витрачає 1.5-3x більше токенів, ніж звичайний — але при ціні $0.003/1M це як і раніше копійки.

Реферальна програма: кожен користувач отримує унікальне реферальне посилання в Dashboard. Коли запрошений користувач витрачає токени — ви отримуєте 10% від його витрат (L1). Якщо ваш реферал теж запрошує людей — ви отримуєте 3% від їхніх витрат (L2). Реферальні нарахування — в GNK-токенах на ваш баланс.

Прозорість: всі транзакції видно в Dashboard — поповнення, списання, реферальні нарахування. API повертає usage об'єкт з кожною відповіддю — ви завжди знаєте, скільки токенів витратив запит.

Параметри моделі: моделі мережі підтримують контекстне вікно 200K токенів. Максимальна довжина відповіді — до 8192 токенів (для всіх моделей мережі; за замовчуванням без max_tokens — 1500). Підтримувані параметри API: model, messages, max_tokens, temperature, tools, tool_choice, stream.