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-нод з моделлю Qwen3-235B.
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 і, звичайно, централізовані провайдери. Порівняємо:

Anthropic API — тільки JoinGonka. Жоден інший gateway до Gonka не підтримує Anthropic Messages API (/v1/messages). Це означає, що інструменти, які працюють через Anthropic-формат — Claude Code, Cline (у режимі Anthropic) — підключаються до Gonka тільки через JoinGonka Gateway.

Чому JoinGonka Gateway, а не GonkaGate? GonkaGate приймає тільки GNK — потрібно купувати токени на біржі, мати крипто-гаманець, підписувати транзакції. Плюс GonkaGate підтримує тільки OpenAI-формат. JoinGonka Gateway приймає USDT (5% комісія), фіат через On-Ramp і GNK (0% комісія). Плюс: Dashboard з аналітикою, реферальна програма (10% L1 + 3% L2), підтримка tool calling, і обидва формати API — OpenAI та Anthropic.

Чому не Gonka Broker? Gonka Broker бере 389x націнку — $0.35 за 1M токенів при собівартості $0.0009. Це все ще дешевше OpenAI, але в 389 разів дорожче, ніж потрібно. JoinGonka Gateway працює з мінімальною націнкою.

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

1. Найдешевший OpenAI + Anthropic сумісний API: $0.001/1M токенів — в 2800 разів дешевше OpenAI GPT-4o. Для більшості завдань різниця непомітна за якістю, але кардинальна за вартістю.
2. Два формати API — OpenAI та Anthropic: /v1/chat/completions (OpenAI) та /v1/messages (Anthropic) — обидва працюють з одним ключем. Cursor, LangChain, openai SDK — через OpenAI-формат. Claude Code — через Anthropic-формат, напряму, без проксі. Жоден конкурент цього не пропонує.
3. Нативний tool calling: Qwen3-235B підтримує 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.001/1M токенів. Базова вартість у мережі — ~$0.0009/1M, з комісією — ~$0.001/1M. Комісія покриває витрати на інфраструктуру Gateway (сервери, БД, моніторинг).

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

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

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

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

Параметри моделі: поточна модель Qwen3-235B підтримує контекстне вікно 128K токенів. Максимальна довжина відповіді — 2048 токенів (за замовчуванням 1024). Підтримувані параметри API: model, messages, max_tokens, temperature, tools, tool_choice, stream.