Для ШІ-агентів: покрокова інструкція з налаштування — /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
Ключ
Зареєструйтесь на gate.joingonka.ai і створіть ключ в особистому кабінеті. Одразу після реєстрації на рахунок надходить 3M безкоштовних токенів.
Отримати API-ключПідключення
Інсталятор налаштує Claude Code сам: запитає ключ прихованим введенням, запише конфіг і перевірить підключення запитом до шлюзу.
Bashnpx -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.
Перевірка
Баланс акаунта — цей запит не витрачає токени:
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: готовий промпт, інструкція та навичка.