> Pour les agents IA : guide de configuration étape par étape — [`/docs/agents.md`](https://gate.joingonka.ai/docs/agents.md), index de la documentation — [`/llms.txt`](https://gate.joingonka.ai/llms.txt).

# Connectez les modèles Gonka à votre outil

API compatible OpenAI et Anthropic. Choisissez votre outil — récupérez la commande d'installation, le prompt pour l'agent et la vérification.

## En bref

- URL de base pour les clients OpenAI API : `https://gate.joingonka.ai/v1`
- URL de base pour les clients Anthropic API, sans `/v1` : `https://gate.joingonka.ai`
- La clé se transmet dans l'en-tête `Authorization: Bearer jg-…` ou `x-api-key: jg-…`
- Liste des modèles disponibles : `GET https://gate.joingonka.ai/v1/models`
- Modèle recommandé : `MiniMaxAI/MiniMax-M2.7`

## Connecter un outil

Choisissez votre outil — les trois étapes ci-dessous lui sont dédiées. L'installateur configure en une seule commande les outils du tableau ci-dessous (25), les autres se connectent via le guide.

### Clé

Inscrivez-vous sur [gate.joingonka.ai](https://gate.joingonka.ai/register) et créez une clé dans votre espace personnel. Dès votre inscription, 3M tokens gratuits sont crédités sur votre compte.

### Connexion

L'installateur configure l'outil tout seul : il demande la clé en saisie masquée, écrit la configuration et teste la connexion. La valeur pour `--tool` se trouve dans le tableau des outils ci-dessous.

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

Ou confiez la configuration à un agent IA — envoyez-lui ce prompt :

```text
Connecte votre outil à JoinGonka Gateway — l'API de la réseau Gonka compatible OpenAI et Anthropic — en suivant les instructions https://gate.joingonka.ai/docs/agents.md. Je te donnerai la clé moi-même : ne l'enregistre pas dans les fichiers du dépôt et ne modifie pas les variables d'environnement globales. À la fin, teste la connexion par une courte requête et indique le résultat.
```

Guides pas à pas pour chaque outil — via les liens du tableau ci-dessous.

### Vérification

Solde du compte — cette requête ne consomme pas de tokens :

```bash
curl -s https://gate.joingonka.ai/api/balance \
  -H "Authorization: Bearer $JOINGONKA_API_KEY"
```

Courte requête vers le modèle — une réponse avec le code 200 signifie que tout est configuré :

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

### Tous les outils

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

## Exemples de code

La même requête via le SDK OpenAI, cURL et le SDK Anthropic. La clé est lue depuis la variable d'environnement `JOINGONKA_API_KEY`.

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

## Sections de la documentation

- [API](https://gate.joingonka.ai/fr/docs/api) — Référence de l'API compatible OpenAI et Anthropic pour les modèles du réseau Gonka : clés, paramètres, streaming, outils, plugins. Jetons gratuits à l'inscription.
- [Modèles](https://gate.joingonka.ai/fr/docs/models) — Les modèles du réseau Gonka dans une seule API : id pour le champ model, contexte, limite de réponse, prix et statut. Les mêmes modèles ouverts à un prix des dizaines de fois inférieur.
- [Erreurs et limites](https://gate.joingonka.ai/fr/docs/errors) — Codes d'erreur de la passerelle, limites de requêtes et délais d'attente : ce que signifie chaque réponse et quand relancer la requête.
- [Tarifs et compte](https://gate.joingonka.ai/fr/docs/billing) — Les modèles du réseau Gonka au prix par jeton : jetons gratuits au démarrage, rechargement en GNK, USDT ou par carte, tous les frais en toute transparence et une API de compte pour suivre vos dépenses.
- [Pour les agents](https://gate.joingonka.ai/fr/docs/agents) — Donnez le lien à un agent IA : il connectera lui-même Claude Code, Cursor ou Codex aux modèles du réseau Gonka — prompt prêt à l'emploi, guide et skill.