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-… or x-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

  1. 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 key
  2. Connection

    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.

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

    Or delegate the setup to an AI agent — send it this prompt:

    Agent prompt
    Connect 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.

  3. Verification

    Account balance — this request doesn't spend tokens:

    cURL
    curl -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:

    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}'

All tools#

ToolTypeInstaller
CursorIDE--tool cursor
Claude CodeCLI agent--tool claude-code
OpenClawCLI agent--tool openclaw
OpenCodeCLI agent--tool opencode
ContinueIDE--tool continue
ClineIDE--tool cline
AiderCLI agent--tool aider
LangChainFramework—
n8nFramework—
Open WebUIChat—
LibreChatChat—
HermesCLI agent--tool hermes
Kilo CodeIDE--tool kilo
Roo CodeIDE--tool roo
LlamaIndexFramework—
PydanticAIFramework—
Vercel AI SDKFramework—
TanStack AIFramework—
ZCodeCLI agent--tool zcode
JetBrainsIDE--tool jetbrains
Copilot BYOKIDE--tool copilot-byok
ZedIDE--tool zed
PiCLI agent--tool pi
Codex CLICLI agent--tool codex
DeepSeek HarnessCLI agent—
MiniMax CodeCLI agent--tool minimax-code
WarpCLI agent—
TraeIDE—
Cherry StudioChat—
omp (Oh My Pi)CLI agent--tool omp
OpenHandsCLI agent—
Qwen CodeCLI agent--tool qwen-code
GooseCLI agent--tool goose
CrushCLI agent--tool crush
Zoo CodeIDE--tool zoo
Kimi CodeCLI agent--tool kimi-code
Factory DroidCLI agent--tool droid
MiMo CodeCLI 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)

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.