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-… 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.

Claude Code

  1. 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é API
  2. Connexion

    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.

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

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

    Prompt pour l'agent
    Connecte 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.

  3. Vérification

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

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

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

Tous les outils#

OutilTypeInstallateur
CursorIDE--tool cursor
Claude CodeAgent CLI--tool claude-code
OpenClawAgent CLI--tool openclaw
OpenCodeAgent CLI--tool opencode
ContinueIDE--tool continue
ClineIDE--tool cline
AiderAgent CLI--tool aider
LangChainFramework—
n8nFramework—
Open WebUIChat—
LibreChatChat—
HermesAgent CLI--tool hermes
Kilo CodeIDE--tool kilo
Roo CodeIDE--tool roo
LlamaIndexFramework—
PydanticAIFramework—
Vercel AI SDKFramework—
TanStack AIFramework—
ZCodeAgent CLI--tool zcode
JetBrainsIDE--tool jetbrains
Copilot BYOKIDE--tool copilot-byok
ZedIDE--tool zed
PiAgent CLI--tool pi
Codex CLIAgent CLI--tool codex
DeepSeek HarnessAgent CLI—
MiniMax CodeAgent CLI--tool minimax-code
WarpAgent CLI—
TraeIDE—
Cherry StudioChat—
omp (Oh My Pi)Agent CLI--tool omp
OpenHandsAgent CLI—
Qwen CodeAgent CLI--tool qwen-code
GooseAgent CLI--tool goose
CrushAgent CLI--tool crush
Zoo CodeIDE--tool zoo
Kimi CodeAgent CLI--tool kimi-code
Factory DroidAgent CLI--tool droid
MiMo CodeAgent 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)

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.