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

  1. 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 erhalten
  2. Verbindung

    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.

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

    Oder beauftrage einen KI-Agenten mit der Einrichtung – sende ihm diesen Prompt:

    Prompt für den Agenten
    Verbinde 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.

  3. Überprüfung

    Kontostand – diese Anfrage verbraucht keine Tokens:

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

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

Alle Tools#

ToolTypInstaller
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-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)

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.