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 обробляє запит на одній з ML-нод, де розгорнута обрана модель — MiniMax M2.7, DeepSeek V4 Flash або GLM-5.3 Flash.
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, WGNK, 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. Бонус: під час реєстрації автоматично нараховується 3M безкоштовних токенів. Цього вистачить на тисячі запитів до 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 токенів одних і тих самих моделей:

Та ж модель — у ~6—58 разів дешевше. JoinGonka Gateway віддає MiniMax-M2.7, DeepSeek-V4-Flash (380K контексту — другий за довжиною в мережі після 390K у GLM-5.3-Flash) та GLM-5.3-Flash за ~$0.0069 на вході та ~$0.021 на виході за 1M токенів (вихід дорожчий утричі — як і в інших провайдерів). На звичайних майданчиках ті ж самі ваги моделі коштують у ~6—58 разів дорожче: причина в архітектурі — у Gonka inference оплачується майнерами через Proof of Useful Work, а не маржою дата-центру.

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

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

1. Найдешевший OpenAI + Anthropic сумісний API: $0.0069/1M токенів — у ~720 разів дешевше за 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: всі моделі мережі підтримують function calling в обох форматах — OpenAI та Anthropic. Агенти, ланцюжки, автоматизація — все працює надійно.
4. Безкоштовний старт: 3M токенів при реєстрації. Цього вистачить на тижні тестування та перші інтеграції — без оплати.
5. Гнучка оплата: GNK (0% комісія), WGNK з Ethereum (1%), 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, баланс зараховується миттєво.
• Поповнення WGNK: 1% комісія. Для GNK у мережі Ethereum — переказ зараховується автоматично.
• Поповнення USDT: 5% комісія. Платите USDT (через OxaPay), Gateway конвертує в GNK автоматично. 5% — плата за зручність (не потрібен крипто-гаманець Gonka).
• Поповнення фіат: через On-Ramp (картка → USDT → GNK). Комісія залежить від провайдера On-Ramp.

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

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

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

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

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

Параметри моделі: контекстне вікно — 200K токенів у MiniMax M2.7, 380K у DeepSeek V4 Flash і 390K у GLM-5.3 Flash. Максимальна довжина відповіді — до 8192 токенів (у DeepSeek V4 Flash — до 32768; за замовчуванням без max_tokens — 1500). Підтримувані параметри API: model, messages, max_tokens, temperature, tools, tool_choice, stream.