> Für KI-Agenten: Schritt-für-Schritt-Anleitung zur Einrichtung — [`/docs/agents.md`](https://gate.joingonka.ai/docs/agents.md), Dokumentationsindex — [`/llms.txt`](https://gate.joingonka.ai/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.

### Schlüssel

Registriere dich auf [gate.joingonka.ai](https://gate.joingonka.ai/register) und erstelle einen Schlüssel in deinem Konto. Direkt nach der Registrierung erhältst du 3M kostenlose Tokens auf dein Konto.

### Verbindung

Der Installer richtet das Tool automatisch ein: Er fragt den Schlüssel per versteckter Eingabe ab, schreibt die Konfiguration und prüft die Verbindung. Den Wert für `--tool` findest du in der Tool-Tabelle unten.

```bash
npx -y @joingonka/setup --tool <id> --model MiniMaxAI/MiniMax-M2.7
```

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

```text
Verbinde eigenes Tool 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-Anleitungen für jedes Tool – über die Links in der Tabelle unten.

### Überprüfung

Kontostand – diese Anfrage verbraucht keine Tokens:

```bash
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:

```bash
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

| Tool | Typ | Installer |
| --- | --- | --- |
| [Cursor](https://joingonka.ai/de/knowledge/cursor/) | IDE | `--tool cursor` |
| [Claude Code](https://joingonka.ai/de/knowledge/claude-code/) | CLI-Agent | `--tool claude-code` |
| [OpenClaw](https://joingonka.ai/de/knowledge/openclaw/) | CLI-Agent | `--tool openclaw` |
| [OpenCode](https://joingonka.ai/de/knowledge/opencode/) | CLI-Agent | `--tool opencode` |
| [Continue](https://joingonka.ai/de/knowledge/continue-dev/) | IDE | `--tool continue` |
| [Cline](https://joingonka.ai/de/knowledge/cline/) | IDE | `--tool cline` |
| [Aider](https://joingonka.ai/de/knowledge/aider/) | CLI-Agent | `--tool aider` |
| [LangChain](https://joingonka.ai/de/knowledge/langchain/) | Framework | — |
| [n8n](https://joingonka.ai/de/knowledge/n8n/) | Framework | — |
| [Open WebUI](https://joingonka.ai/de/knowledge/open-webui/) | Chat | — |
| [LibreChat](https://joingonka.ai/de/knowledge/librechat/) | Chat | — |
| [Hermes](https://joingonka.ai/de/knowledge/hermes/) | CLI-Agent | `--tool hermes` |
| [Kilo Code](https://joingonka.ai/de/knowledge/kilo-code/) | IDE | `--tool kilo` |
| [Roo Code](https://joingonka.ai/de/knowledge/roo-code/) | IDE | `--tool roo` |
| [LlamaIndex](https://joingonka.ai/de/knowledge/llamaindex/) | Framework | — |
| [PydanticAI](https://joingonka.ai/de/knowledge/pydantic-ai/) | Framework | — |
| [Vercel AI SDK](https://joingonka.ai/de/knowledge/vercel-ai-sdk/) | Framework | — |
| [TanStack AI](https://joingonka.ai/de/knowledge/tanstack-ai/) | Framework | — |
| [ZCode](https://joingonka.ai/de/knowledge/zcode/) | CLI-Agent | `--tool zcode` |
| [JetBrains](https://joingonka.ai/de/knowledge/jetbrains/) | IDE | `--tool jetbrains` |
| [Copilot BYOK](https://joingonka.ai/de/knowledge/copilot-byok/) | IDE | `--tool copilot-byok` |
| [Zed](https://joingonka.ai/de/knowledge/zed/) | IDE | `--tool zed` |
| [Pi](https://joingonka.ai/de/knowledge/pi/) | CLI-Agent | `--tool pi` |
| [Codex CLI](https://joingonka.ai/de/knowledge/codex/) | CLI-Agent | `--tool codex` |
| [DeepSeek Harness](https://joingonka.ai/de/knowledge/deepseek-harness/) | CLI-Agent | — |
| [MiniMax Code](https://joingonka.ai/de/knowledge/minimax-code/) | CLI-Agent | `--tool minimax-code` |
| [Warp](https://joingonka.ai/de/knowledge/warp/) | CLI-Agent | — |
| [Trae](https://joingonka.ai/de/knowledge/trae/) | IDE | — |
| [Cherry Studio](https://joingonka.ai/de/knowledge/cherry-studio/) | Chat | — |
| [omp (Oh My Pi)](https://joingonka.ai/de/knowledge/omp/) | CLI-Agent | `--tool omp` |
| [OpenHands](https://joingonka.ai/de/knowledge/openhands/) | CLI-Agent | — |
| [Qwen Code](https://joingonka.ai/de/knowledge/qwen-code/) | CLI-Agent | `--tool qwen-code` |
| [Goose](https://joingonka.ai/de/knowledge/goose/) | CLI-Agent | `--tool goose` |
| [Crush](https://joingonka.ai/de/knowledge/crush/) | CLI-Agent | `--tool crush` |
| [Zoo Code](https://joingonka.ai/de/knowledge/zoo-code/) | IDE | `--tool zoo` |
| [Kimi Code](https://joingonka.ai/de/knowledge/kimi-code/) | CLI-Agent | `--tool kimi-code` |
| [Factory Droid](https://joingonka.ai/de/knowledge/factory-droid/) | CLI-Agent | `--tool droid` |
| [MiMo Code](https://joingonka.ai/de/knowledge/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.

### Python

```python
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)
```

### TypeScript

```typescript
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

```bash
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?"}]
  }'
```

### Anthropic SDK

```python
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](https://gate.joingonka.ai/de/docs/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](https://gate.joingonka.ai/de/docs/models) — 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](https://gate.joingonka.ai/de/docs/errors) — Fehlercodes des Gateways, Rate-Limits und Timeouts: Was jede Antwort bedeutet und wann du die Anfrage wiederholen solltest.
- [Tarife und Konto](https://gate.joingonka.ai/de/docs/billing) — 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](https://gate.joingonka.ai/de/docs/agents) — 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.