> ## Documentation Index
> Fetch the complete documentation index at: https://gccai.heqingsong.uk/llms.txt
> Use this file to discover all available pages before exploring further.
# Utiliser GccAi dans Cherry Studio
> Guide détaillé sur la façon de configurer et d'utiliser le service API GccAi dans le client de bureau Cherry Studio. Ce guide vous aidera à configurer l'API GccAi dans Cherry Studio pour accéder à de riches ressources de modèles d'IA.
## Prérequis
Avant de commencer, assurez-vous que :
1. **Cherry Studio est installé**\
Téléchargez et installez la version adaptée à votre système d'exploitation depuis le [site officiel de Cherry Studio](https://cherry-ai.com/)
2. **Clé API GccAi obtenue**\
Connectez-vous à la [console GccAi](https://gccai.heqingsong.uk/keys) pour obtenir votre clé API (commence par `sk-`)
> [!NOTE]
>
> **Astuce :** si vous n'avez pas encore de compte GccAi, inscrivez-vous d'abord sur [GccAi](https://gccai.heqingsong.uk) et obtenez une clé API.
## Étape 1 : Ouvrir les paramètres de Cherry Studio
Après avoir lancé Cherry Studio, accédez à la page des paramètres :
1. Cliquez sur l'icône **⚙️ Paramètres** (engrenage) en haut à droite
2. Ou utilisez les raccourcis clavier :
* Windows/Linux : `Ctrl + ,`
* macOS : `Cmd + ,`
*Interface principale de Cherry Studio, cliquez sur l'engrenage en haut à droite pour accéder aux paramètres*
## Étape 2 : Ajouter la plateforme de modèles GccAi
### 2.1 Accéder à la gestion du service de modèles
Sur la page des paramètres :
1. Trouvez l'option **Service de modèles** dans le menu de gauche
2. Cliquez pour ouvrir la page de gestion du service de modèles
*Trouvez l'option « Service de modèles » dans le menu de gauche de la page des paramètres*
### 2.2 Ajouter le fournisseur GccAi
1. En bas de la page du service de modèles, cliquez sur le bouton **« + Ajouter »**
*Cliquez sur « + Ajouter » pour ouvrir la boîte de dialogue d'ajout de fournisseur*
2. Dans la boîte de dialogue **« Ajouter un fournisseur »**, remplissez :
* **Nom du fournisseur** : `GccAi` (personnalisable)
* **Type de fournisseur** : sélectionnez `OpenAI`
3. Cliquez sur le bouton **« Confirmer »**
### 2.3 Configurer les informations API GccAi
Après avoir ajouté le fournisseur, remplissez les informations API dans la zone de configuration à droite :
| Champ | Valeur |
| - | - |
| **API Key** | Votre clé API GccAi (`sk-xxxxxxxxxxxx`) |
| **API URL** | `https://gccai.heqingsong.uk` |
> [!NOTE]
>
> **Important :**
>
> * L'API URL doit être `https://gccai.heqingsong.uk` (n'incluez pas `/v1` ou d'autres chemins)
> * L'API Key doit être obtenue depuis la console GccAi et commencer par `sk-`
> * Après avoir rempli, vous pouvez cliquer sur le bouton **« Tester »** pour tester la connexion
*Renseignez la clé API et l'URL de l'API, assurez-vous que l'état du fournisseur GccAi est ACTIVÉ (interrupteur vert)*
## Étape 3 : Ajouter et gérer les modèles
### 3.1 Ouvrir la gestion des modèles
Après avoir configuré le fournisseur GccAi :
1. Assurez-vous que l'interrupteur du fournisseur GccAi en haut à droite est **ACTIVÉ** (vert)
2. Dans la zone de configuration à droite, trouvez la section **« Modèles »**
3. Cliquez sur le bouton **« Gérer »** pour ouvrir la fenêtre de sélection des modèles
*Cliquez sur le bouton « Gérer » pour ouvrir la fenêtre de sélection des modèles GccAi*
### 3.2 Ajouter les modèles souhaités
Dans la fenêtre de sélection des modèles :
1. Utilisez la zone de recherche pour trouver des modèles spécifiques
2. Utilisez les onglets de catégorie en haut pour filtrer : **Tous**, **Reasoning**, **Vision**, **Web**, **Free**, **Embedding**, **Rerank**, **Tool**
3. Trouvez les modèles souhaités et cliquez sur le bouton **+** à droite pour les ajouter :
* `gpt-4o` / `chatgpt-4o` — modèle OpenAI GPT-4o
* `gpt-4o-mini` — version plus rapide et plus économique
* Série `claude-3` — modèles Claude 3 (avec plusieurs variantes)
* `claude_code_sonnet-4` — Claude Code Sonnet 4
* `claude_code_haiku-4` — Claude Code Haiku 4
* `gemini-2.0-flash-exp` — Google Gemini 2.0 Flash
*Les modèles ajoutés apparaîtront à droite, et peuvent être développés pour voir les variantes spécifiques*
4. Après avoir ajouté tous les modèles souhaités, fermez la fenêtre de sélection des modèles
> [!TIP]
>
> **Modèles recommandés :**
>
> * 💰 **Économique :** `gpt-4o-mini`, `claude_code_haiku-4`
> * 🚀 **Haute performance :** `gpt-4o` / `chatgpt-4o`, `claude_code_sonnet-4`
> * 🎨 **Multimodal :** série `claude-3`, `gemini-2.0-flash-exp`
## Étape 4 : Commencer à discuter
Une fois configuré, vous pouvez commencer à l'utiliser :
1. Revenez à l'interface principale, cliquez sur le **« + »** en haut ou sélectionnez un chat existant
2. En haut de la page de chat, cliquez sur le sélecteur de modèle
3. Sélectionnez un modèle sous le fournisseur **GccAi**
4. Commencez à discuter avec l'IA !
*Créez un nouveau chat et sélectionnez le fournisseur et le modèle GccAi*
*Exemple d'interface de chat de Cherry Studio*
## FAQ
### Q1 : Impossible de se connecter au service GccAi ?
**Solution :**
1. **Vérifier la Base URL** :
* Assurez-vous que la Base URL est `https://gccai.heqingsong.uk`
* N'ajoutez pas de suffixe `/v1`
2. **Vérifier la clé API** :
* Confirmez que la clé API est correcte et commence par `sk-`
* Vérifiez la validité de la clé dans la [console GccAi](https://gccai.heqingsong.uk/keys)
3. **Vérifier la connexion réseau** :
* Assurez-vous que vous pouvez accéder à `https://gccai.heqingsong.uk`
* Vous devrez peut-être configurer un proxy si vous êtes en Chine
### Q2 : La liste des modèles est vide ou ne peut pas être actualisée ?
**Solution :**
1. **Ajouter manuellement les modèles** :
* Si l'actualisation automatique échoue, vous pouvez ajouter manuellement les modèles courants
* Dans la gestion des modèles, entrez manuellement les noms des modèles (par ex. `gpt-4o`)
2. **Vérifier les permissions API** :
* Confirmez que votre clé API a la permission d'accéder à la liste des modèles
* Contactez le support GccAi pour vérifier l'état du compte
### Q3 : Messages d'erreur pendant la conversation ?
**Erreurs courantes et solutions :**
| Message d'erreur | Cause | Solution |
| - | - | - |
| `401 Unauthorized` | Clé API invalide ou expirée | Récupérez à nouveau la clé API et mettez à jour la configuration |
| `429 Too Many Requests` | Limite de débit dépassée | Attendez un moment et réessayez |
| `500 Internal Server Error` | Problème temporaire du serveur | Attendez quelques minutes et réessayez |
| `insufficient_quota` | Solde de compte insuffisant | Rechargez dans la console |
### Q4 : Comment consulter l'utilisation et les coûts de l'API ?
Connectez-vous à la [console GccAi](https://gccai.heqingsong.uk/overview) pour voir :
* 📊 Statistiques d'appels API
* 💰 Détails des coûts
* 📈 Graphiques de tendance d'utilisation
## Fonctionnalités
En utilisant Cherry Studio + GccAi, vous pouvez :
* 💬 **Conversations multi-modèles** — utiliser différents modèles d'IA dans la même interface
* 🖼️ **Compréhension d'images** — conversations multimodales avec prise en charge de l'entrée d'images
* 📝 **Gestion du contexte** — gestion intelligente de l'historique des conversations et du contexte
* 🎨 **Prompts personnalisés** — créer et gérer des modèles de prompts
* 📊 **Exporter les conversations** — exporter les enregistrements de conversation en Markdown et autres formats
* 🔄 **Comparaison de modèles** — utiliser plusieurs modèles simultanément et comparer les sorties
## Support et aide
Si vous rencontrez des problèmes :
* 📚 [Documentation GccAi](https://gccai.heqingsong.uk)
* 💬 [Communauté Discord](https://discord.gg/V8zqssyZ5c)
* 🐦 [Twitter @GccAi\_](https://x.com/GccAi_)
* 📧 Support technique : [zhihong@gccai.heqingsong.uk](mailto:zhihong@gccai.heqingsong.uk)
***
> **[Commencer à utiliser GccAi](https://gccai.heqingsong.uk)**
>
> Inscrivez-vous à GccAi maintenant, obtenez votre clé API et commencez votre aventure IA !
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.