Для ИИ-агентов: пошаговая инструкция по настройке — /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
Ключ
Зарегистрируйтесь на gate.joingonka.ai и создайте ключ в личном кабинете. Сразу после регистрации на счёт приходит 3M бесплатных токенов.
Получить API-ключПодключение
Установщик настроит Claude Code сам: спросит ключ скрытым вводом, запишет конфиг и проверит подключение запросом к шлюзу.
Bashnpx -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.
Проверка
Баланс аккаунта — этот запрос не тратит токены:
cURLcurl -s https://gate.joingonka.ai/api/balance \ -H "Authorization: Bearer $JOINGONKA_API_KEY"Короткий запрос к модели — ответ с кодом 200 значит, что всё настроено:
cURLcurl -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}'
Все инструменты#
| Инструмент | Тип | Установщик |
|---|---|---|
| Cursor | IDE | --tool cursor |
| Claude Code | CLI-агент | --tool claude-code |
| OpenClaw | CLI-агент | --tool openclaw |
| OpenCode | CLI-агент | --tool opencode |
| Continue | IDE | --tool continue |
| Cline | IDE | --tool cline |
| Aider | CLI-агент | --tool aider |
| LangChain | Фреймворк | — |
| n8n | Фреймворк | — |
| Open WebUI | Чат | — |
| LibreChat | Чат | — |
| Hermes | CLI-агент | --tool hermes |
| Kilo Code | IDE | --tool kilo |
| Roo Code | IDE | --tool roo |
| LlamaIndex | Фреймворк | — |
| PydanticAI | Фреймворк | — |
| Vercel AI SDK | Фреймворк | — |
| TanStack AI | Фреймворк | — |
| ZCode | CLI-агент | --tool zcode |
| JetBrains | IDE | --tool jetbrains |
| Copilot BYOK | IDE | --tool copilot-byok |
| Zed | IDE | --tool zed |
| Pi | CLI-агент | --tool pi |
| Codex CLI | CLI-агент | --tool codex |
| DeepSeek Harness | CLI-агент | — |
| MiniMax Code | CLI-агент | --tool minimax-code |
| Warp | CLI-агент | — |
| Trae | IDE | — |
| Cherry Studio | Чат | — |
| omp (Oh My Pi) | CLI-агент | --tool omp |
| OpenHands | CLI-агент | — |
| Qwen Code | CLI-агент | --tool qwen-code |
| Goose | CLI-агент | --tool goose |
| Crush | CLI-агент | --tool crush |
| Zoo Code | IDE | --tool zoo |
| Kimi Code | CLI-агент | --tool kimi-code |
| Factory Droid | CLI-агент | --tool droid |
| MiMo Code | CLI-агент | --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)import OpenAI from "openai";
const client = new OpenAI({
baseURL: "https://gate.joingonka.ai/v1",
apiKey: process.env.JOINGONKA_API_KEY,
});
const response = await client.chat.completions.create({
model: "MiniMaxAI/MiniMax-M2.7",
messages: [{ role: "user", content: "What is Gonka?" }],
});
console.log(response.choices[0].message.content);curl 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": "What is Gonka?"}]
}'import os
import anthropic
client = anthropic.Anthropic(
base_url="https://gate.joingonka.ai",
api_key=os.environ["JOINGONKA_API_KEY"],
)
message = client.messages.create(
model="MiniMaxAI/MiniMax-M2.7",
max_tokens=1024,
messages=[{"role": "user", "content": "What is Gonka?"}],
)
print(message.content[0].text)Разделы документации#
- API — Справочник OpenAI- и Anthropic-совместимого API к моделям сети Gonka: ключи, параметры, стриминг, инструменты, плагины. Бесплатные токены при регистрации.
- Модели — Модели сети Gonka в одном API: id для поля model, контекст, лимит ответа, цены и статус. Те же открытые модели в десятки раз дешевле.
- Ошибки и лимиты — Коды ошибок шлюза, лимиты запросов и таймауты: что означает каждый ответ и когда повторять запрос.
- Тарифы и аккаунт — Модели сети Gonka по цене за токен: бесплатные токены на старте, пополнение GNK, USDT или картой, все комиссии открыто и API аккаунта для учёта расходов.
- Для агентов — Отдайте ссылку ИИ-агенту — он сам подключит Claude Code, Cursor или Codex к моделям сети Gonka: готовый промпт, инструкция и навык.