Trae + JoinGonka Gateway — modèles du réseau Gonka dans AI-IDE

Build et version. Trae a deux branches : l'internationale (documentation sur docs.trae.ai) et la chinoise (docs.trae.cn). Le formulaire Custom Model existe dans les deux et fonctionne de la même manière ; ce qui diffère, ce sont les modèles intégrés et l'ensemble des presets dans les réglages avancés. L'adresse de requête personnalisée pour son propre modèle est prise en charge depuis la version 3.5.51 du 14 avril 2026 — si votre build est plus ancienne, mettez-la à jour. La build internationale n'est pas disponible dans tous les pays : avant d'installer, consultez la liste des pays et régions pris en charge.

Système. macOS 12 et plus récent, Windows 10 ou 11 (x64), Linux via les paquets .deb et .rpm. Au premier lancement, Trae propose de choisir un thème et une langue, d'importer les réglages depuis VS Code ou Cursor et de se connecter à un compte.

Clé JoinGonka. Inscrivez-vous sur la passerelle, ouvrez la section « Clés API » dans votre espace et cliquez sur « Créer une clé ». La clé commence par jg- et n'est affichée qu'une seule fois — enregistrez-la immédiatement. Astuce pratique : créez une clé distincte pour Trae, sa consommation apparaîtra sur une ligne dédiée dans la section « Utilisation ».

Forfait Trae. Votre propre modèle doit être sélectionné manuellement dans la liste des modèles, or dans le tableau des forfaits Trae, la ligne de sélection de modèle du plan gratuit ne mentionne que le mode Auto — qui n'utilise pas de modèles personnalisés. La documentation ne dit pas clairement si cette restriction s'applique aux modèles ajoutés via sa propre clé. La règle pratique est simple : si sur votre forfait Auto Mode se désactive dans la liste des modèles, tout est prêt ; sinon, il faudra un forfait payant.

1. Ouvrez Settings → Models — le panneau de gestion des modèles.
2. Cliquez sur Add Model. Dans la fenêtre qui s'ouvre, choisissez l'option Custom Model, et non un fournisseur de la liste prédéfinie.
3. Remplissez les champs avec les valeurs du tableau. Il y a deux colonnes — une pour chaque format d'API ; choisissez-en une.
4. Cliquez sur Add Model. Trae effectuera un appel API d'essai et vérifiera la clé : en cas de succès, le modèle apparaîtra dans la liste ; en cas d'échec, la fenêtre affichera un message d'erreur et le log de la réponse du fournisseur.

Les autres champs ne dépendent pas du format :

Quel format choisir. Commencez par OpenAI Chat Completions : c'est la voie principale de la passerelle, la plupart des outils fonctionnent avec. Anthropic Messages sera utile si vous êtes habitué à ce format dans d'autres outils ou si vous souhaitez comparer le comportement de l'agent sur les deux protocoles — la clé et le solde leur sont communs.

Comment fonctionne Full URL. Le commutateur détermine qui ajoute le chemin. Désactivé — vous fournissez l'adresse de base, et Trae ajoute le chemin selon le format choisi : /chat/completions à l'adresse avec /v1 pour OpenAI, et /v1/messages à la racine pour Anthropic. Activé — l'adresse est utilisée telle quelle, et le chemin doit y figurer entièrement. L'erreur la plus fréquente est de mélanger les modes : saisir le chemin complet avec le commutateur désactivé, ou l'adresse de base avec le commutateur activé.

Une entrée — un modèle. Répétez les étapes pour les autres modèles du réseau afin de basculer entre eux sans revenir dans les paramètres : deepseek-ai/DeepSeek-V4-Flash-0731, MiniMaxAI/MiniMax-M2.7 et zai-org/GLM-5.3-Flash. La liste à jour est renvoyée par GET https://gate.joingonka.ai/v1/models. Un modèle ajouté pourra ensuite être modifié, désactivé (il restera dans le panneau mais disparaîtra de la liste dans le chat) ou supprimé.

Sous les champs principaux se trouve une liste déroulante Advanced Settings. Vous n'avez pas besoin d'y toucher — Trae appliquera les valeurs par défaut — mais deux réglages méritent d'être définis consciemment : la série du modèle et la fenêtre de contexte.

Le prix des modèles du réseau est identique, donc le choix dépend du comportement. Tous les modèles du tableau prennent en charge le tool calling natif, sur lequel repose le travail des agents Trae.

La gestion du budget de raisonnement et la raison pour laquelle les modèles de raisonnement ne doivent pas avoir une limite de sortie trop basse sont expliquées dans l'aperçu de GLM-5.3 Flash ; la comparaison des modèles pour les tâches de développement se trouve dans l'article sur les meilleurs modèles pour le code.

Vos modèles sont regroupés dans la liste générale : cliquez sur le nom du modèle actuel dans le coin inférieur droit du champ de saisie du chat et sélectionnez celui que vous avez ajouté. Le commutateur Auto Mode se trouve également à cet endroit — il doit être désactivé : en mode Auto, Trae sélectionne lui-même un modèle parmi ceux intégrés et n'utilise pas ceux que vous avez ajoutés.

Donnez à l'agent une tâche nécessitant un outil, par exemple : « Lis le package.json et liste les scripts de build ». L'agent doit ouvrir le fichier et répondre de manière pertinente — cela signifie que la boucle « requête — appel d'outil — réponse » est établie via la passerelle (gateway). Ensuite, ouvrez le tableau de bord de la passerelle, section « Utilisation » : dans le bloc « Par clés », les requêtes et l'heure de la dernière interaction apparaîtront pour la clé Trae, et dans le bloc « Par modèles », le modèle sélectionné sera affiché.

Si quelque chose ne fonctionne pas, examinez le texte de l'erreur. Trae ne masque pas la réponse de votre propre modèle : il affiche l'erreur du fournisseur telle quelle, avec son propre code 4028.

Un agent dans un IDE consomme des jetons (tokens) plus rapidement qu'un chat : chaque requête inclut des instructions système, une description des outils, les fichiers ouverts et l'historique des étapes. Par conséquent, le prix par jeton détermine s'il est possible de lancer l'agent pour chaque détail ou s'il faut économiser.

Via JoinGonka Gateway, les jetons coûtent $0.0069 par million en entrée et $0.021 par million en sortie — le prix est identique pour tous les modèles du réseau et est mis à jour sur cette page depuis une source en direct. Ordre de grandeur des prix en septembre 2026 :

La comparaison avec Trae lui-même est parlante, car il existe des modèles ouverts parmi les modèles intégrés, et Trae publie leur liste de prix par million de jetons. DeepSeek-V4-Flash et MiniMax-M2.7 coûtent là-bas $0.30 en entrée et $1.20 en sortie, et GLM-5.3 Flash ne figure pas du tout dans la liste intégrée de la version internationale. Via la passerelle, la différence pour ces mêmes modèles est d'environ ×43 en entrée et ×58 en sortie.

Votre propre modèle fonctionne là où il y a une liste de modèles. Il s'agit du chat et des agents — à la fois en mode IDE et en mode SOLO (les modèles personnalisés y sont pris en charge depuis la version 3.3.0). L'autocomplétion et la prédiction des modifications sont gérées par un mécanisme distinct appelé CUE, doté de son propre panneau de configuration : il n'y a pas de choix de modèle, et ses limites sont définies par le plan tarifaire Trae.

Outils et MCP. Les agents Trae agissent en tant que clients MCP, et les serveurs que vous connectez restent accessibles à l'agent sur son propre modèle : tous les modèles du réseau prennent en charge l'appel natif d'outils. Si Trae indique que le schéma des arguments de l'outil est incompatible avec le modèle (code 4027), essayez un modèle voisin du réseau ou un autre serveur MCP.

TraeWork. Dans l'application séparée TraeWork, le formulaire d'ajout de votre propre modèle est identique, mais selon la documentation, il ne fonctionne que dans TraeWork Desktop et uniquement pour les tâches dans un environnement local.

Plugin pour d'autres éditeurs. Dans la documentation du plugin TraeCode pour VS Code et JetBrains, il n'y a pas de section sur les modèles personnalisés — ce guide concerne l'IDE de bureau. Si vous restez dans VS Code, la même passerelle est connectée via des extensions d'agent, comme Cline.

Confidentialité. Le paramètre Privacy Mode (Settings → Account) contrôle ce que Trae lui-même fait de vos conversations et fragments de code : avec cette option activée, ils ne sont pas utilisés pour l'analyse et l'entraînement. Du côté de la passerelle, les conversations ne sont pas stockées : les invites et les réponses ne sont pas conservées après la réponse, seuls les compteurs de requêtes et de jetons sont visibles dans le tableau de bord.

Si vous avez besoin de travailler avec des images — une maquette, une capture d'écran d'erreur — confiez cette tâche au modèle intégré avec vision, et laissez le code, les commandes et les fichiers au modèle du réseau : le basculement se fait en un clic dans la liste des modèles.