Passer au contenu principal
Cherry Studio est un client de bureau multiplateforme (Windows, macOS, Linux) qui regroupe de nombreux fournisseurs de modèles dans une seule application. Ajoutez Tokios en tant que fournisseur OpenAI personnalisé — pointez-le vers https://api.tokios.com/v1, collez une clé sk-tok-…, et ajoutez le nom de votre déploiement Tokios en tant que modèle — et Cherry Studio communiquera avec un modèle exécuté sur votre propre matériel au lieu d’un fournisseur hébergé.

​
Prérequis

Connecteur appairé

Installez et appairez tokios-connector à côté du modèle que vous souhaitez que Cherry Studio atteigne.

Modèle enregistré

Enregistrez un déploiement (nom public) pour ce modèle.

Clé API créée

Créez une clé sk-tok-…, éventuellement limitée à ce déploiement.

Backends pris en charge

Confirmez que votre backend local (Ollama, llama.cpp, vLLM, LM Studio) est en cours d’exécution.

​
Ajouter Tokios en tant que fournisseur dans Cherry Studio

1

Ouvrir les paramètres du fournisseur de modèles

Ouvrez Settings (l’icône d’engrenage) et accédez à l’onglet Model Services. Certaines versions étiquettent cela Model Provider — la documentation de Cherry Studio est traduite du chinois, donc la formulation exacte peut varier selon la version.
2

Ajouter un fournisseur

Cliquez sur + Add. Dans la boîte de dialogue Add Provider, entrez un Provider name (par exemple, Tokios) et définissez le Provider type sur OpenAI — c’est le paramètre pour n’importe quel point de terminaison générique compatible OpenAI.
3

Définir l'adresse API et la clé

Remplissez les champs du fournisseur :
Incluez /v1 dans l’API address vous-même. Cherry Studio n’ajoute pas toujours le chemin de manière fiable pour un fournisseur personnalisé, donc donnez-lui la base complète /v1.
4

Ajouter votre déploiement en tant que modèle

Cherry Studio ne liste pas automatiquement les modèles pour un fournisseur personnalisé — ajoutez-en un manuellement en utilisant le nom de déploiement public que vous avez enregistré dans l’onglet Models, par exemple gemma-tunnel. C’est la valeur que Cherry Studio envoie dans le champ model ; ce n’est pas l’identifiant de modèle local d’Ollama, de llama.cpp, de vLLM ou de LM Studio.
Remplacez gemma-tunnel par le nom de déploiement que vous avez enregistré, et sk-tok-YOUR_KEY par votre propre clé. N’engagez jamais l’un ou l’autre dans un fichier de configuration partagé.

​
Application de bureau, modèle ailleurs

La configuration courante que cela résout : Cherry Studio s’exécute sur votre ordinateur portable ou de bureau, mais le modèle que vous souhaitez — plus grand que ce que cette machine peut exécuter — réside sur une station de travail ou un serveur ailleurs. Le connecteur à côté de ce modèle appelle Tokios, et Cherry Studio appelle https://api.tokios.com/v1 avec votre clé sk-tok-…. Vous conservez l’interface utilisateur de Cherry Studio avec un modèle qui n’est pas local à la machine sur laquelle vous tapez — aucun port entrant, aucun VPN.

​
Dépannage

La clé API envoyée par Cherry Studio est manquante, malformée ou a été révoquée. Confirmez que vous avez collé la clé complète sk-tok-… sans espace supplémentaire, et vérifiez son statut dans l’onglet Keys.
La valeur du modèle envoyée par Cherry Studio ne correspond pas à un déploiement enregistré, ou l’API address manque /v1. Confirmez que le nom du modèle correspond au nom public dans l’onglet Models, et que l’adresse est https://api.tokios.com/v1.
Le connecteur pour ce déploiement est hors ligne ou a atteint sa limite de concurrence. Vérifiez l’onglet Connectors — le connecteur doit afficher Online, et la machine qui l’exécute doit toujours être allumée et accessible.

​
Étapes suivantes

Clients compatibles

Consultez la configuration de l’URL de base et de la clé pour d’autres clients compatibles OpenAI et Anthropic.

Clés API

Créez, limitez et faites pivoter les clés sk-tok-… pour les membres de l’équipe et les agents.