For AI agents: step-by-step setup guide — /docs/agents.md, documentation index — /llms.txt.
Connect Gonka models to your tool
OpenAI- and Anthropic-compatible API. Pick your tool — get the install command, an agent prompt, and a verification step.
Quick facts#
- Base URL for OpenAI API clients:
https://gate.joingonka.ai/v1 - Base URL for Anthropic API clients, without
/v1:https://gate.joingonka.ai - The key is passed in the
Authorization: Bearer jg-…orx-api-key: jg-…header - List of available models:
GET https://gate.joingonka.ai/v1/models - Recommended model:
MiniMaxAI/MiniMax-M2.7
Connect a tool#
Pick your tool — below are three steps tailored to it. The installer configures the tools in the table below (25 of them) with a single command; the rest are connected via a guide.
Claude Code
Key
Sign up at gate.joingonka.ai and create a key in your dashboard. Right after signing up, 3M free tokens land in your account.
Get an API keyConnection
The installer will set up Claude Code on its own: it prompts for the key with hidden input, writes the config, and verifies the connection with a request to the gateway.
Bashnpx -y @joingonka/setup --tool claude-code --model MiniMaxAI/MiniMax-M2.7Or delegate the setup to an AI agent — send it this prompt:
Agent promptConnect Claude Code to JoinGonka Gateway — the OpenAI- and Anthropic-compatible API of the Gonka network — following the instructions at https://gate.joingonka.ai/docs/agents.md. I'll provide the key myself: don't save it in repository files and don't modify global environment variables. At the end, verify the connection with a short request and report the result.Step-by-step guide: Claude Code.
Verification
Account balance — this request doesn't spend tokens:
cURLcurl -s https://gate.joingonka.ai/api/balance \ -H "Authorization: Bearer $JOINGONKA_API_KEY"A short request to the model — a 200 response means everything is set up:
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}'
All tools#
| Tool | Type | Installer |
|---|---|---|
| Cursor | IDE | --tool cursor |
| Claude Code | CLI agent | --tool claude-code |
| OpenClaw | CLI agent | --tool openclaw |
| OpenCode | CLI agent | --tool opencode |
| Continue | IDE | --tool continue |
| Cline | IDE | --tool cline |
| Aider | CLI agent | --tool aider |
| LangChain | Framework | — |
| n8n | Framework | — |
| Open WebUI | Chat | — |
| LibreChat | Chat | — |
| Hermes | CLI agent | --tool hermes |
| Kilo Code | IDE | --tool kilo |
| Roo Code | IDE | --tool roo |
| LlamaIndex | Framework | — |
| PydanticAI | Framework | — |
| Vercel AI SDK | Framework | — |
| TanStack AI | Framework | — |
| ZCode | CLI agent | --tool zcode |
| JetBrains | IDE | --tool jetbrains |
| Copilot BYOK | IDE | --tool copilot-byok |
| Zed | IDE | --tool zed |
| Pi | CLI agent | --tool pi |
| Codex CLI | CLI agent | --tool codex |
| DeepSeek Harness | CLI agent | — |
| MiniMax Code | CLI agent | --tool minimax-code |
| Warp | CLI agent | — |
| Trae | IDE | — |
| Cherry Studio | Chat | — |
| omp (Oh My Pi) | CLI agent | --tool omp |
| OpenHands | CLI agent | — |
| Qwen Code | CLI agent | --tool qwen-code |
| Goose | CLI agent | --tool goose |
| Crush | CLI agent | --tool crush |
| Zoo Code | IDE | --tool zoo |
| Kimi Code | CLI agent | --tool kimi-code |
| Factory Droid | CLI agent | --tool droid |
| MiMo Code | CLI agent | --tool mimo-code |
Code examples#
The same request via the OpenAI SDK, cURL, and the Anthropic SDK. The key is read from the JOINGONKA_API_KEY environment variable.
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)Documentation sections#
- API — Reference for the OpenAI- and Anthropic-compatible API to Gonka network models: keys, parameters, streaming, tools, plugins. Free tokens when you sign up.
- Models — Gonka network models in a single API: id for the model field, context, output limit, pricing, and status. The same open models at a fraction of the cost.
- Errors & Rate Limits — Gateway error codes, request limits, and timeouts: what each response means and when to retry your request.
- Pricing & Account — Gonka network models priced per token: free tokens to start, top up with GNK, USDT, or a card, all fees out in the open, and an account API to track your spending.
- For Agents — Hand the link to your AI agent and it will connect Claude Code, Cursor, or Codex to Gonka network models on its own: ready-made prompt, guide, and skill.