Utiliser OneAster dans Cherry Studio

​

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
2. Clé API OneAster obtenue
   Connectez-vous à la console OneAster pour obtenir votre clé API (commence par sk-)

​

É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 + ,

​

Étape 2 : Ajouter la plateforme de modèles OneAster

​

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

​

2.2 Ajouter le fournisseur OneAster

1. En bas de la page du service de modèles, cliquez sur le bouton « + Ajouter »

2. Dans la boîte de dialogue « Ajouter un fournisseur », remplissez :
   • Nom du fournisseur : oneaster (personnalisable)
   • Type de fournisseur : sélectionnez OpenAI
3. Cliquez sur le bouton « Confirmer »

​

2.3 Configurer les informations API OneAster

Après avoir ajouté le fournisseur, remplissez les informations API dans la zone de configuration à droite :

​

Étape 3 : Ajouter et gérer les modèles

​

3.1 Ouvrir la gestion des modèles

Après avoir configuré le fournisseur OneAster :

1. Assurez-vous que l’interrupteur du fournisseur OneAster 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

​

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

4. Après avoir ajouté tous les modèles souhaités, fermez la fenêtre de sélection des modèles

​

É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 OneAster
4. Commencez à discuter avec l’IA !

​

FAQ

​

Q1 : Impossible de se connecter au service OneAster ?

Solution :

1. Vérifier la Base URL :
   • Assurez-vous que la Base URL est https://api.oneaster.ai
   • 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 OneAster
3. Vérifier la connexion réseau :
   • Assurez-vous que vous pouvez accéder à https://api.oneaster.ai
   • 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 OneAster pour vérifier l’état du compte

​

Q3 : Messages d’erreur pendant la conversation ?

Erreurs courantes et solutions :

​

Q4 : Comment consulter l’utilisation et les coûts de l’API ?

Connectez-vous à la console OneAster pour voir :

• 📊 Statistiques d’appels API
• 💰 Détails des coûts
• 📈 Graphiques de tendance d’utilisation

​

Fonctionnalités

En utilisant Cherry Studio + OneAster, 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 OneAster
• 💬 Communauté Discord
• 🐦 Twitter @oneaster_
• 📧 Support technique : [email protected]

---