Для ШІ-агентів: покрокова інструкція з налаштування — /docs/agents.md, індекс документації — /llms.txt.

Підключіть моделі Gonka до свого інструмента

API, сумісний з OpenAI та Anthropic. Виберіть інструмент — отримайте команду встановлення, промпт для агента та перевірку.

Швидкі факти#

  • Базова адреса для клієнтів OpenAI API: https://gate.joingonka.ai/v1
  • Базова адреса для клієнтів Anthropic API, без /v1: https://gate.joingonka.ai
  • Ключ передається в заголовку Authorization: Bearer jg-… або x-api-key: jg-…
  • Список доступних моделей: GET https://gate.joingonka.ai/v1/models
  • Рекомендована модель: MiniMaxAI/MiniMax-M2.7

Підключити інструмент#

Виберіть свій інструмент — нижче три кроки саме для нього. Інсталятор налаштовує однією командою інструменти з таблиці нижче (їх 25), решта підключаються за гайдом.

Claude Code

  1. Ключ

    Зареєструйтесь на gate.joingonka.ai і створіть ключ в особистому кабінеті. Одразу після реєстрації на рахунок надходить 3M безкоштовних токенів.

    Отримати API-ключ
  2. Підключення

    Інсталятор налаштує Claude Code сам: запитає ключ прихованим введенням, запише конфіг і перевірить підключення запитом до шлюзу.

    Bash
    npx -y @joingonka/setup --tool claude-code --model MiniMaxAI/MiniMax-M2.7

    Або доручіть налаштування ІІ-агенту — надішліть йому цей промпт:

    Промпт для агента
    Підключи Claude Code до JoinGonka Gateway — API мережі Gonka, сумісного з OpenAI та Anthropic — за інструкцією https://gate.joingonka.ai/docs/agents.md. Ключ я дам сам: не зберігай його у файлах репозиторію і не змінюй глобальні змінні середовища. Наприкінці перевір підключення коротким запитом і повідом результат.

    Покроковий гайд: Claude Code.

  3. Перевірка

    Баланс акаунта — цей запит не витрачає токени:

    cURL
    curl -s https://gate.joingonka.ai/api/balance \
      -H "Authorization: Bearer $JOINGONKA_API_KEY"

    Короткий запит до моделі — відповідь із кодом 200 означає, що все налаштовано:

    cURL
    curl -s https://gate.joingonka.ai/v1/chat/completions \
      -H "Authorization: Bearer $JOINGONKA_API_KEY" \
      -H "Content-Type: application/json" \
      -d '{"model": "MiniMaxAI/MiniMax-M2.7", "messages": [{"role": "user", "content": "Say OK"}], "max_tokens": 32}'

Усі інструменти#

ІнструментТипІнсталятор
CursorIDE--tool cursor
Claude CodeCLI-агент--tool claude-code
OpenClawCLI-агент--tool openclaw
OpenCodeCLI-агент--tool opencode
ContinueIDE--tool continue
ClineIDE--tool cline
AiderCLI-агент--tool aider
LangChainФреймворк—
n8nФреймворк—
Open WebUIЧат—
LibreChatЧат—
HermesCLI-агент--tool hermes
Kilo CodeIDE--tool kilo
Roo CodeIDE--tool roo
LlamaIndexФреймворк—
PydanticAIФреймворк—
Vercel AI SDKФреймворк—
TanStack AIФреймворк—
ZCodeCLI-агент--tool zcode
JetBrainsIDE--tool jetbrains
Copilot BYOKIDE--tool copilot-byok
ZedIDE--tool zed
PiCLI-агент--tool pi
Codex CLICLI-агент--tool codex
DeepSeek HarnessCLI-агент—
MiniMax CodeCLI-агент--tool minimax-code
WarpCLI-агент—
TraeIDE—
Cherry StudioЧат—
omp (Oh My Pi)CLI-агент--tool omp
OpenHandsCLI-агент—
Qwen CodeCLI-агент--tool qwen-code
GooseCLI-агент--tool goose
CrushCLI-агент--tool crush
Zoo CodeIDE--tool zoo
Kimi CodeCLI-агент--tool kimi-code
Factory DroidCLI-агент--tool droid
MiMo CodeCLI-агент--tool mimo-code

Приклади коду#

Той самий запит через OpenAI SDK, cURL та Anthropic SDK. Ключ береться зі змінної середовища JOINGONKA_API_KEY.

import os
from openai import OpenAI

client = OpenAI(
    base_url="https://gate.joingonka.ai/v1",
    api_key=os.environ["JOINGONKA_API_KEY"],
)

response = client.chat.completions.create(
    model="MiniMaxAI/MiniMax-M2.7",
    messages=[{"role": "user", "content": "What is Gonka?"}],
)
print(response.choices[0].message.content)

Розділи документації#

  • API — Довідник OpenAI- та Anthropic-сумісного API до моделей мережі Gonka: ключі, параметри, стримінг, інструменти, плагіни. Безкоштовні токени під час реєстрації.
  • Моделі — Моделі мережі Gonka в одному API: id для поля model, контекст, ліміт відповіді, ціни та статус. Ті самі відкриті моделі в десятки разів дешевше.
  • Помилки та ліміти — Коди помилок шлюзу, ліміти запитів і таймаути: що означає кожна відповідь і коли повторювати запит.
  • Тарифи й акаунт — Моделі мережі Gonka за ціною за токен: безкоштовні токени на старті, поповнення GNK, USDT або карткою, усі комісії відкрито та API акаунта для обліку витрат.
  • Для агентів — Дайте посилання ШІ-агенту — він сам підключить Claude Code, Cursor або Codex до моделей мережі Gonka: готовий промпт, інструкція та навичка.