Configurer BetterToken dans Cherry Studio : fournisseur personnalisé, API Host et modèles
Ajoutez BetterToken à Cherry Studio comme fournisseur personnalisé compatible OpenAI ou Anthropic, ajoutez des Model IDs, vérifiez la connexion et corrigez les erreurs courantes.
Pour connecter Cherry Studio à BetterToken, ajoutez un fournisseur personnalisé, saisissez votre BetterToken API Key et l’API Host, puis ajoutez un Model ID actuel depuis le catalogue de modèles.
Paramètres principaux
| Champ | Valeur |
|---|---|
| Type de fournisseur | OpenAI (compatible OpenAI) |
| API Key | BetterToken API Key |
| Base URL | https://bettertoken.ai (API Host) |
| Modèle | Un Model ID actuel du catalogue de modèles |
Prérequis
- La version actuelle de Cherry Studio est installée
- Une BetterToken API Key : inscrivez-vous pour en obtenir une
- Un Model ID du catalogue de modèles
Vous avez déjà un compte ? Connectez-vous, rechargez votre solde, puis créez une clé dans la console.
Installation
Téléchargez Cherry Studio pour votre système depuis le site officiel ou les GitHub Releases, installez-le et ouvrez-le. Aucun plugin supplémentaire n’est nécessaire.
Configuration manuelle
Toute la configuration se fait dans les paramètres de Cherry Studio. Vous n’avez pas besoin de modifier de fichier de configuration.
Ajouter un fournisseur personnalisé
Ouvrez Settings → Model Provider, cliquez sur Add, saisissez un nom comme BetterToken et choisissez le type de fournisseur OpenAI.
Saisir l'API Key et l'API Host
- API Key → votre BetterToken API Key
- API Host →
https://bettertoken.ai
Cherry Studio ajoute lui-même le chemin de la requête. Vérifiez l’aperçu de l’URL de requête sous le champ : il doit afficher https://bettertoken.ai/v1/chat/completions. Ne collez pas une URL /chat/completions complète dans API Host.
Ajouter des modèles
Cliquez sur Manage pour récupérer la liste des modèles, ou sur Add pour saisir un Model ID manuellement, par exemple claude-sonnet-5-5, gpt-6-sol ou deepseek-flash.
Vérifier la connexion
Cliquez sur Check, sélectionnez l’un des modèles ajoutés et attendez le message de réussite. Activez ensuite le fournisseur.
Utiliser plutôt le protocole Anthropic
Pour les modèles Claude, vous pouvez ajouter un second fournisseur personnalisé de type Anthropic avec l’API Host https://bettertoken.ai. Cherry Studio envoie alors les requêtes vers /v1/messages. Utilisez ce fournisseur uniquement pour les modèles Claude. Pour tous les autres modèles, utilisez le type de fournisseur OpenAI.
Vérifier la connexion
Démarrez une nouvelle conversation, choisissez un modèle BetterToken dans le sélecteur et envoyez Répondez par un seul mot : OK. Une réponse normale signifie que la configuration fonctionne.
Changer de modèle
Choisissez un autre modèle BetterToken dans le sélecteur de modèle de la conversation. Si le modèle n’est pas encore dans la liste, ouvrez le fournisseur BetterToken, cliquez sur Add et saisissez son Model ID exact depuis le catalogue de modèles.
Erreurs fréquentes
| Erreur | Que vérifier |
|---|---|
401 / Unauthorized | Vérifiez la BetterToken API Key et supprimez les espaces au début ou à la fin. |
404 | Vérifiez que API Host vaut https://bettertoken.ai et que l’aperçu de l’URL de requête ne se termine qu’une seule fois par /v1/chat/completions. |
model not found | Copiez un Model ID actuel depuis le catalogue de modèles. |
| Liste de modèles vide | Ajoutez le Model ID manuellement avec Add. |
Configuration avancée
Guides connexes
Détails techniques
Protocole et endpoint
Le type de fournisseur OpenAI envoie les requêtes à https://bettertoken.ai/v1/chat/completions, le type Anthropic à https://bettertoken.ai/v1/messages. Dans les deux cas, saisissez uniquement https://bettertoken.ai dans API Host.

