Для ИИ-агентов: пошаговая инструкция по настройке — /docs/agents.md, индекс документации — /llms.txt.

Подключите модели Gonka к своему инструменту

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

Быстрые факты#

  • Базовый адрес для клиентов 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 — OpenAI- и Anthropic-совместимому API сети Gonka — по инструкции 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: готовый промпт, инструкция и навык.