Cherry Studio + JoinGonka Gateway — client AI de bureau

Installation. Les builds pour tous les systèmes se trouvent sur la page des releases du projet : installateur et version portable pour Windows, image dmg pour macOS, AppImage, deb et rpm pour Linux — en x64 et ARM. L'historique des conversations et les réglages sont stockés localement, sur votre machine.

V1 ou V2. En août 2026, la gamme V2 est sortie avec une nouvelle organisation des données et des réglages repensés ; le dernier build de la gamme précédente est le 1.9.13. Le fournisseur personnalisé existe dans les deux, seuls diffèrent la forme d'ajout et certaines libellés — ces endroits sont signalés ci-dessous. Lors du passage de V1, les réglages des fournisseurs et des modèles sont transférés automatiquement, les données d'origine V1 sont conservées, mais les nouvelles données ne se resynchronisent pas en arrière, et les sauvegardes des deux gammes sont incompatibles. Avant de mettre à jour, lisez la section sur la migration dans la documentation Cherry Studio.

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. Il est pratique de créer une clé distincte pour Cherry Studio : dans la section « Utilisation », sa consommation apparaîtra sur une ligne séparée.

1. Cliquez sur l'icône en forme d'engrenage — les paramètres s'ouvrent. Choisissez la section Model Provider (appelée Model Services dans la documentation anglaise).
2. Sous la liste des fournisseurs, cliquez sur Add Provider.
3. En V2, la boîte de dialogue Add Custom Provider s'ouvre. Saisissez le Provider Name — par exemple JoinGonka. Dans le bloc Endpoint settings, renseignez la ligne OpenAI avec l'adresse https://gate.joingonka.ai/v1 : une ligne Request path apparaît sous le champ avec le chemin final — il doit se terminer par /v1/chat/completions. Dans le champ API Key, collez jg-your-key puis cliquez sur Add.
4. En V1, la boîte de dialogue est plus courte : le nom du fournisseur et le Provider Type — choisissez OpenAI. La clé et l'adresse se saisissent directement sur la page du fournisseur, dans les champs API Key et API Host.
5. Vérifiez que le fournisseur est activé : l'interrupteur se trouve dans le coin supérieur droit de sa page. En V2, les nouveaux fournisseurs sont ajoutés désactivés, et les modèles d'un fournisseur désactivé n'apparaissent pas dans les listes de sélection.

Comment Cherry Studio assemble l'adresse. Le champ API Host accepte une adresse de base, et l'application ajoute elle-même le chemin puis affiche le résultat dans la ligne Preview sous le champ. Les règles sont identiques dans les deux versions :

Dans les anciennes instructions, on trouve encore une autre règle : un slash à la fin de l'adresse désactiverait prétendument /v1. Elle était valable dans les premières versions, jusqu'à la série 1.6 incluse, et a été supprimée en 1.7 : dans les versions actuelles, seul # désactive l'ajout automatique.

Le fournisseur est ajouté, mais n'est pas encore visible dans le chat : seules les modèles que vous avez explicitement ajoutés apparaissent dans les listes de sélection de Cherry Studio. Il y a deux façons de faire.

Liste depuis le serveur. Sur la page du fournisseur, cliquez sur Sync models (dans la V1 — Manage, puis Fetch model list). Cherry Studio interrogera la passerelle avec GET /v1/models et affichera la composition en direct du réseau ; ajoutez les modèles souhaités avec le bouton +. Manuellement. Le bouton Add Model ouvre un formulaire où un champ est obligatoire — Model ID : l'identifiant doit être saisi caractère par caractère.

Le prix des modèles du réseau est identique, ajoutez-les donc tous — vous devrez choisir entre eux en fonction de leur comportement, et non de votre budget :

Types de modèle. Chaque modèle de la liste dispose d'un bouton de paramètres où ses capacités sont cochées : Vision, Reasoning, Tool, etc. Cherry Studio coche automatiquement certaines options, mais pour les modèles de la passerelle, il vaut mieux les vérifier. Vision doit être décoché : les modèles du réseau sont textuels. Tool est nécessaire si vous connectez des outils MCP — l'appel natif d'outils est pris en charge par tous les modèles du tableau. Reasoning est approprié pour GLM-5.3 Flash — c'est le modèle de raisonnement du réseau.

Modèle par défaut. Dans la section des paramètres Default Model, on définit les modèles pour les rôles utilitaires. Définissez DeepSeek V4 Flash comme modèle principal de l'assistant. Pour le modèle rapide qui génère des titres de dialogue et prépare des requêtes de recherche, la documentation de Cherry Studio conseille un modèle léger et rapide, non spécialisé en raisonnement — parmi les modèles du réseau, MiniMax M2.7 est le mieux adapté à ce rôle, évitez d'y mettre GLM-5.3 Flash avec son raisonnement obligatoire. Pour la traduction, n'importe lequel des deux premiers fera l'affaire.

Sur la page du fournisseur, dans le bloc de la clé, il y a un bouton Model Check (en V1 — Check à côté du champ de clé). Choisissez un modèle : Cherry Studio lui enverra une courte requête d'essai et affichera le résultat avec le temps de réponse. Si le test passe, allez dans le chat, sélectionnez le modèle de la passerelle dans le sélecteur de modèles et posez n'importe quelle question.

Pour vérifier que les requêtes passent bien par la passerelle, ouvrez son espace client, rubrique « Utilisation » : dans le bloc « Par clés », la clé Cherry Studio affichera les requêtes et l'heure du dernier appel ; dans le bloc « Par modèles », le modèle sélectionné. La V2 dispose aussi de ses propres statistiques client, dans la rubrique de réglages Usage : tokens et requêtes par fournisseurs, modèles et clés. Le coût y est indicatif — Cherry Studio l'estime d'après les tarifs publics des modèles, et non selon le prix du réseau Gonka ; pour les montants exacts, consultez donc l'espace client de la passerelle.

Si quelque chose ne va pas, la cause se lit presque toujours dans la réponse :

Le client lui-même est distribué gratuitement, vous ne payez que pour l'inférence. 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 récupéré sur cette page depuis une source en temps réel. Le chat consomme des jetons de manière nettement plus modeste que les outils d'agent, donc l'ordre de grandeur des prix en septembre 2026 est le suivant :

Une précision importante concernant les longs dialogues : à chaque réplique, le client renvoie au modèle tout l'historique, donc la centième réplique coûte plus cher que la première. Le remède est de créer un nouveau dialogue pour une nouvelle tâche ; dans Cherry Studio, c'est un seul bouton.

Comparaison de modèles dans une seule discussion. Cherry Studio peut poser la même question à plusieurs modèles simultanément : sélectionnez-les dans le sélecteur de modèles, et chacun répondra par une requête séparée. Avec un prix unique pour tous les modèles du réseau, c'est le moyen le plus rapide de comprendre sur vos tâches où MiniMax M2.7 suffit, où une réponse longue de DeepSeek V4 Flash est nécessaire, et où le raisonnement de GLM-5.3 Flash s'avère payant — ses paramètres sont analysés dans l'aperçu du modèle.

Second protocole avec la même clé. La passerelle répond également au format Anthropic. Dans la discussion V2, il existe une ligne Anthropic distincte dans le bloc Endpoint settings : saisissez https://gate.joingonka.ai, et dans la ligne Request path, vous devriez obtenir le chemin /v1/messages. Dans la V1, le même résultat est obtenu avec un fournisseur distinct avec Provider Type Anthropic et la même adresse. Sous le bouton More options dans la V2, il y a également une ligne OpenAI Responses — la passerelle la prend aussi en charge, l'adresse est la même que pour la ligne OpenAI principale.

Exécution d'agents terminaux. Sur la page Code CLI (Coding Companion dans la documentation), Cherry Studio installe et exécute des agents en console, en leur transmettant le fournisseur et le modèle issus de ses paramètres ; la liste des fournisseurs y est filtrée selon le protocole requis par l'outil spécifique. C'est pourquoi l'adresse Anthropic doit être remplie à l'avance si vous prévoyez d'exécuter Claude Code à partir d'ici. Comment configurer le même agent sans intermédiaires — voir le guide Claude Code + Gonka.

Base de connaissances. Dans la V2, elle fonctionne même sans modèle d'embedding — grâce à la recherche textuelle BM25, et avec un modèle d'embedding, la recherche hybride est activée. Les modèles du réseau Gonka sont génératifs, donc pour le mode hybride, utilisez un modèle d'embedding d'un autre fournisseur, par exemple un modèle local via Ollama ; les réponses basées sur les fragments trouvés seront fournies par le modèle de la passerelle.

Besoin d'un chat commun pour l'équipe dans le navigateur ? Cherry Studio est un client de bureau personnel. Pour une interface Web commune avec des comptes, consultez Open WebUI : il se connecte à la passerelle avec la même adresse et la même clé.