Pour les agents IA : guide de configuration étape par étape — /docs/agents.md, index de la documentation — /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-…oux-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.
Claude Code
Clé
Inscrivez-vous sur gate.joingonka.ai et créez une clé dans votre espace personnel. Dès votre inscription, 3M tokens gratuits sont crédités sur votre compte.
Obtenir une clé APIConnexion
L'installateur configure Claude Code automatiquement : il demande la clé en saisie masquée, écrit la configuration et teste la connexion par une requête vers la passerelle.
Bashnpx -y @joingonka/setup --tool claude-code --model MiniMaxAI/MiniMax-M2.7Ou confiez la configuration à un agent IA — envoyez-lui ce prompt :
Prompt pour l'agentConnecte Claude Code à 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.Guide pas à pas : Claude Code.
Vérification
Solde du compte — cette requête ne consomme pas de tokens :
cURLcurl -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é :
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}'
Tous les outils#
| Outil | Type | Installateur |
|---|---|---|
| Cursor | IDE | --tool cursor |
| Claude Code | Agent CLI | --tool claude-code |
| OpenClaw | Agent CLI | --tool openclaw |
| OpenCode | Agent CLI | --tool opencode |
| Continue | IDE | --tool continue |
| Cline | IDE | --tool cline |
| Aider | Agent CLI | --tool aider |
| LangChain | Framework | — |
| n8n | Framework | — |
| Open WebUI | Chat | — |
| LibreChat | Chat | — |
| Hermes | Agent CLI | --tool hermes |
| Kilo Code | IDE | --tool kilo |
| Roo Code | IDE | --tool roo |
| LlamaIndex | Framework | — |
| PydanticAI | Framework | — |
| Vercel AI SDK | Framework | — |
| TanStack AI | Framework | — |
| ZCode | Agent CLI | --tool zcode |
| JetBrains | IDE | --tool jetbrains |
| Copilot BYOK | IDE | --tool copilot-byok |
| Zed | IDE | --tool zed |
| Pi | Agent CLI | --tool pi |
| Codex CLI | Agent CLI | --tool codex |
| DeepSeek Harness | Agent CLI | — |
| MiniMax Code | Agent CLI | --tool minimax-code |
| Warp | Agent CLI | — |
| Trae | IDE | — |
| Cherry Studio | Chat | — |
| omp (Oh My Pi) | Agent CLI | --tool omp |
| OpenHands | Agent CLI | — |
| Qwen Code | Agent CLI | --tool qwen-code |
| Goose | Agent CLI | --tool goose |
| Crush | Agent CLI | --tool crush |
| Zoo Code | IDE | --tool zoo |
| Kimi Code | Agent CLI | --tool kimi-code |
| Factory Droid | Agent CLI | --tool droid |
| 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.
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)Sections de la documentation#
- 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 — 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 — 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 — 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 — 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.