Für KI-Agenten: Schritt-für-Schritt-Anleitung zur Einrichtung — /docs/agents.md, Dokumentationsindex — /llms.txt.
Verbinde Gonka-Modelle mit deinem Tool
OpenAI- und Anthropic-kompatible API. Wähle dein Tool – erhalte den Installationsbefehl, einen Prompt für den Agenten und eine Überprüfung.
Schnelle Fakten#
- Basis-URL für OpenAI-API-Clients:
https://gate.joingonka.ai/v1 - Basis-URL für Anthropic-API-Clients, ohne
/v1:https://gate.joingonka.ai - Der Schlüssel wird im Header
Authorization: Bearer jg-…oderx-api-key: jg-…übergeben - Liste der verfügbaren Modelle:
GET https://gate.joingonka.ai/v1/models - Empfohlenes Modell:
MiniMaxAI/MiniMax-M2.7
Tool verbinden#
Wähle dein Tool – unten findest du die drei Schritte speziell dafür. Der Installer konfiguriert die Tools aus der Tabelle unten (25 Stück) mit einem einzigen Befehl, alle anderen werden per Anleitung verbunden.
Claude Code
Schlüssel
Registriere dich auf gate.joingonka.ai und erstelle einen Schlüssel in deinem Konto. Direkt nach der Registrierung erhältst du 3M kostenlose Tokens auf dein Konto.
API-Schlüssel erhaltenVerbindung
Der Installer richtet Claude Code automatisch ein: Er fragt den Schlüssel per versteckter Eingabe ab, schreibt die Konfiguration und prüft die Verbindung mit einer Anfrage an das Gateway.
Bashnpx -y @joingonka/setup --tool claude-code --model MiniMaxAI/MiniMax-M2.7Oder beauftrage einen KI-Agenten mit der Einrichtung – sende ihm diesen Prompt:
Prompt für den AgentenVerbinde Claude Code mit dem JoinGonka Gateway – der OpenAI- und Anthropic-kompatiblen API des Gonka-Netzwerks – gemäß der Anleitung https://gate.joingonka.ai/docs/agents.md. Den Schlüssel gebe ich selbst an: Speichere ihn nicht in Repository-Dateien und ändere keine globalen Umgebungsvariablen. Prüfe am Ende die Verbindung mit einer kurzen Anfrage und melde das Ergebnis.Schritt-für-Schritt-Anleitung: Claude Code.
Überprüfung
Kontostand – diese Anfrage verbraucht keine Tokens:
cURLcurl -s https://gate.joingonka.ai/api/balance \ -H "Authorization: Bearer $JOINGONKA_API_KEY"Kurze Anfrage an das Modell – eine Antwort mit Statuscode 200 bedeutet, dass alles eingerichtet ist:
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}'
Alle Tools#
| Tool | Typ | 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-Beispiele#
Dieselbe Anfrage über das OpenAI SDK, cURL und das Anthropic SDK. Der Schlüssel wird aus der Umgebungsvariable JOINGONKA_API_KEY gelesen.
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)Dokumentationsbereiche#
- API — Referenz zur OpenAI- und Anthropic-kompatiblen API für die Modelle des Gonka-Netzwerks: Keys, Parameter, Streaming, Tools, Plugins. Kostenlose Tokens bei der Registrierung.
- Modelle — Modelle des Gonka-Netzwerks in einer API: ID für das Feld model, Kontext, Antwortlimit, Preise und Status. Dieselben offenen Modelle zu einem Bruchteil des Preises.
- Fehler und Limits — Fehlercodes des Gateways, Rate-Limits und Timeouts: Was jede Antwort bedeutet und wann du die Anfrage wiederholen solltest.
- Tarife und Konto — Modelle des Gonka-Netzwerks zum Preis pro Token: kostenlose Tokens zum Start, Aufladen mit GNK, USDT oder Karte, alle Gebühren transparent und eine Konto-API zur Kostenkontrolle.
- Für Agenten — Gib einem KI-Agenten den Link — er verbindet Claude Code, Cursor oder Codex selbst mit den Modellen des Gonka-Netzwerks: fertiger Prompt, Anleitung und Skill.