Configuration de Cherry Studio
Cherry Studio est un client de bureau IA multiplateforme (Windows, macOS, Linux) avec conversations multi-modèles, base de connaissances et workflows — l’un des clients IA open source les plus complets.
En configurant OfoxAI comme fournisseur, vous pouvez utiliser GPT, Claude, Gemini, DeepSeek et plus de 100 modèles dans Cherry Studio avec une seule clé API.
Présentation des protocoles
Cherry Studio prend en charge la connexion à OfoxAI via quatre protocoles :
OpenAI Chat — Basé sur /v1/chat/completions, pour les modèles GPT comme openai/gpt-4.1, openai/gpt-5.3-chat.
OpenAI Response — Basé sur /v1/responses, pour les modèles GPT comme openai/gpt-4.1, openai/gpt-5.4-mini.
Claude — Basé sur /anthropic/v1/messages, pour les modèles Claude comme anthropic/claude-sonnet-4.6, anthropic/claude-opus-4.6.
Gemini — Basé sur /gemini/v1beta/models, pour les modèles Gemini comme google/gemini-3.1-pro-preview, google/gemini-3.1-flash-lite-preview.
Prérequis
- Un compte OfoxAI avec une clé API (Obtenir ici )
- Cherry Studio installé (Télécharger )
Étapes de configuration
Étape 1 : Ouvrir les paramètres
Lancez Cherry Studio et cliquez sur l’icône Paramètres en bas à gauche.
Étape 2 : Ajouter un fournisseur de modèles
Allez dans Services de modèles dans la barre latérale gauche, faites défiler jusqu’en bas et cliquez sur + Ajouter. Dans la boîte de dialogue, entrez un nom de fournisseur et sélectionnez le type correspondant.
OpenAI Chat
Sélectionnez OpenAI comme type de fournisseur et cliquez sur OK.
OpenAI Response
Sélectionnez OpenAI comme type de fournisseur (le mode Response sera activé plus tard sur la page de configuration) et cliquez sur OK.
Claude
Sélectionnez Anthropic comme type de fournisseur et cliquez sur OK.
Gemini
Sélectionnez Gemini comme type de fournisseur et cliquez sur OK.
Étape 3 : Saisir la configuration API
Remplissez la clé API et l’adresse API sur la page de configuration du fournisseur.
OpenAI Chat
| Champ | Valeur |
|---|---|
| Clé API | Votre clé API OfoxAI |
| Adresse API | https://api.ofox.ai/v1 |
OpenAI Response
| Champ | Valeur |
|---|---|
| Clé API | Votre clé API OfoxAI |
| Adresse API | https://api.ofox.ai/v1 |
Claude
| Champ | Valeur |
|---|---|
| Clé API | Votre clé API OfoxAI |
| Adresse API | https://api.ofox.ai/anthropic |
Gemini
| Champ | Valeur |
|---|---|
| Clé API | Votre clé API OfoxAI |
| Adresse API | https://api.ofox.ai/gemini |
Assurez-vous que le bouton en haut à droite de la page est activé (ON), sinon le fournisseur n’apparaîtra pas dans le sélecteur de modèles.
Étape 4 : Ajouter des modèles
Cliquez sur le bouton Gérer dans la section des modèles pour récupérer automatiquement la liste des modèles, puis cliquez sur + à côté d’un modèle pour l’ajouter à la liste activée.
OpenAI Chat
OpenAI Response
Claude
Gemini
Étape 5 : Vérifier la configuration
Cliquez sur le bouton Tester, sélectionnez un modèle pour tester. Un résultat réussi signifie que la configuration est correcte.
OpenAI Chat
OpenAI Response
Claude
Gemini
Commencer à utiliser
Retournez à l’interface principale, cliquez sur le sélecteur de modèles en haut du chat et choisissez un modèle dans le groupe de fournisseurs correspondant pour commencer à discuter.
Génération d’images
Cherry Studio prend en charge la génération d’images via le protocole Gemini en utilisant les modèles de génération d’images d’OfoxAI, directement dans les conversations.
Étape 1 : Ajouter un fournisseur Gemini
Allez dans Services de modèles et cliquez sur + Ajouter en bas.
Dans la boîte de dialogue, sélectionnez Gemini comme type de fournisseur et cliquez sur OK.
Étape 2 : Configurer et récupérer les modèles d’image
Saisissez https://api.ofox.ai/gemini comme adresse API, cliquez sur Récupérer la liste des modèles et ajoutez les modèles de génération d’images suivants :
Google: Nano Banana Pro (Gemini 3 Pro Image Preview)Google: Nano Banana (Gemini 2.5 Flash Image)Google: Nano Banana 2 (Gemini 3.1 Flash Image Preview)
Étape 3 : Modifier l’assistant et configurer les paramètres d’image
Faites un clic droit sur un assistant dans l’interface principale et sélectionnez Modifier l’assistant.
Sur la page de modification :
- Définissez le Modèle par défaut sur le modèle de génération d’images que vous venez d’ajouter
- Cliquez sur + Ajouter un paramètre et ajoutez les deux paramètres personnalisés suivants :
| Paramètre | Type | Valeur |
|---|---|---|
responseModalities | JSON | ["IMAGE"] |
imageConfig | JSON | {"aspectRatio": "1:1", "imageSize": "1K"} |
Vous pouvez ajuster le rapport d’aspect et la résolution dans imageConfig. Pour des images 2K, changez imageSize en "2K".
Étape 4 : Commencer à générer
Après avoir enregistré la configuration, entrez une description d’image dans le chat pour générer des images.
Questions fréquentes
Q : La liste des modèles est vide après avoir cliqué sur « Gérer »
Vérifiez que l’adresse API est correcte (pas de barre oblique à la fin) et que la clé API a été copiée complètement sans espaces supplémentaires.
Q : Échec de connexion lors de la vérification
- Confirmez que la clé API a été copiée complètement depuis la Console OfoxAI sans espaces supplémentaires
- Confirmez que l’adresse API est correcte
- Confirmez que votre connexion réseau fonctionne
Q : Le fournisseur n’apparaît pas dans le sélecteur de modèles
Vérifiez que le bouton en haut à droite de la page de configuration est activé.