Connecter GPT et une API tierce à Cherry Studio
Choisissez le bon protocole, entrez l'URL racine du fournisseur, ajoutez l'ID de modèle exact et vérifiez une petite demande avant d'étendre la configuration.
La recherche de comment connecter GPT à Cherry Studio signifie généralement que vous avez besoin d'une configuration de fournisseur fonctionnelle, et non d'une présentation des fonctionnalités. Les champs importants sont le protocole, la clé API, l'URL de base et l'ID de modèle exact.
Le chemin court est :
Paramètres → Service de modèle → choisir ou ajouter un fournisseur → saisir les informations d'identification et l'URL API → récupérer ou ajouter un modèle → activer le fournisseur → exécuter une vérification de l'état.
Cherry Studio dispose de fournisseurs intégrés pour des services tels que OpenAI, Anthropic, Google Gemini, DeepSeek, Moonshot, Ollama et LM Studio. Une passerelle ou un service auto-hébergé peut être ajouté via un fournisseur personnalisé lorsqu'il expose un point de terminaison compatible OpenAI, Anthropic ou Gemini. Consultez le guide officiel des paramètres du fournisseur pour connaître les noms actuels de l'interface utilisateur.
Ce dont vous avez besoin avant d’ouvrir Cherry Studio
Préparez quatre valeurs du service que vous souhaitez utiliser :
| Valeur | Ce que cela signifie |
|---|---|
| Protocole | Compatible OpenAI, messages Anthropic, Gemini ou format documenté du fournisseur |
| Clé API | Les informations d'identification utilisées pour authentifier la demande |
| Base URL | L'adresse racine API, sauf si le fournisseur exige explicitement un point de terminaison complet |
| Model ID | La chaîne exacte acceptée par le API en amont |
N'utilisez pas de mot de passe de chat Web comme clé API. Un abonnement ChatGPT, un compte API et une passerelle tierce sont des chemins d'accès distincts. Utilisez les informations d'identification et le point de terminaison documentés par le service que vous avez sélectionné.
Connectez GPT en cinq étapes
Service de modèle ouvert 1.
Démarrez Cherry Studio et ouvrez Paramètres → Service modèle. Choisissez le fournisseur OpenAI intégré lorsque vous appelez directement OpenAI. Pour une passerelle, un agrégateur ou un déploiement privé, choisissez Ajouter un fournisseur et créez une entrée personnalisée distincte.
Le fournisseur est sélectionné par son protocole, et non par le mot GPT dans le nom du modèle. Un modèle étiqueté GPT derrière une passerelle compatible Anthropic a toujours besoin du profil de protocole Anthropic.
2. Remplissez les champs du fournisseur
Utilisez la documentation du fournisseur pour chaque champ :
| Champ Cherry Studio | Que saisir | Éviter |
|---|---|---|
| Nom du fournisseur | Une étiquette que vous reconnaîtrez plus tard | Réutiliser une étiquette pour des points de terminaison non liés |
| Clé API | La valeur clé uniquement | Espaces supplémentaires, guillemets ou Bearer |
| Type API | Le protocole que le point final implémente réellement | Deviner à partir du nom marketing du modèle |
| Adresse API | L'URL racine documentée ou l'URL complète requise | Une URL de tableau de bord ou un chemin dupliqué |
Pour un service compatible OpenAI conventionnel, Cherry Studio attend généralement l'adresse racine et ajoute la version et le chemin de la demande. Si un fournisseur affiche à la fois https://api.example.com et https://api.example.com/v1/chat/completions, la première est l'URL de base normale. N'ajoutez pas /v1 deux fois. Utilisez un chemin complet uniquement lorsque le fournisseur le demande explicitement.
Le guide du fournisseur personnalisé couvre les points de terminaison supplémentaires, la saisie manuelle du modèle et les services locaux de style vLLM.
3. Récupérer ou ajouter le modèle
Cliquez sur Obtenir la liste des modèles. Si le point de terminaison expose la découverte de modèle, ajoutez le modèle avec le bouton +. L'ID renvoyé fait autorité : conservez les dates, les préfixes du fournisseur, les traits d'union et les suffixes de version exactement comme indiqué.
Si le fournisseur n'expose pas de liste de modèles, ajoutez le modèle manuellement. Une sauvegarde réussie du fournisseur ne rend pas automatiquement un modèle disponible dans le sélecteur de discussion. Le modèle doit être ajouté et le changement de fournisseur doit être activé.
4. Cochez une courte demande
Utilisez Vérifiez avec le modèle que vous venez d'ajouter, puis envoyez une invite minimale :
Reply with exactly: connection successful
Cela sépare les problèmes d'authentification et de routage des problèmes de vision, d'outils, de contexte long ou de capacité de l'agent. Confirmez l'appel sur la page d'utilisation du fournisseur lorsqu'elle est disponible.
5. Ajoutez des fonctionnalités avancées une par une
Une fois le texte brut travaillé, testez le streaming, les images, les outils ou les paramètres de raisonnement un par un. Une réponse réussie par chat prouve seulement que la route textuelle de base fonctionne ; cela ne prouve pas que le modèle ou le protocole prend en charge toutes les fonctionnalités exposées par Cherry Studio.
Connexion d'autres API tierces
Passerelles compatibles OpenAI
Utilisez Fournisseur personnalisé → OpenAI lorsque la passerelle documente OpenAI Chat Completions ou une autre surface compatible OpenAI. Il s'agit du chemin habituel pour les agrégateurs, les passerelles privées, les vLLM et de nombreux modèles ouverts hébergés.
Passerelles multiprotocoles
Les passerelles de style NewAPI peuvent exposer les conversations OpenAI, les réponses OpenAI, les messages Anthropic et les routes Gemini à partir d'une seule adresse racine. Les [instructions NewAPI] de Cherry Studio (https://docs.cherryai.com.cn/pre-basic/providers/newapi.md) expliquent que le client sélectionne le chemin de version pour le protocole choisi. Utilisez le préréglage NewAPI lorsque la passerelle suit ce contrat ; utilisez un fournisseur personnalisé lorsqu'il dispose d'un chemin documenté ou d'une variation de découverte de modèle.
Ollama, LM Studio et vLLM
Sélectionnez le fournisseur local correspondant ou utilisez un fournisseur OpenAI personnalisé lorsque le serveur local expose un API compatible avec OpenAI. Entrez le nom du modèle que le serveur local a réellement chargé. L'exécution locale peut réduire l'exposition des données, mais les modèles locaux diffèrent toujours en termes de vision, d'outils, de longueur de contexte et de support de raisonnement.
Lorsque la liste des modèles est vide
Effectuez ces vérifications dans l’ordre :
- Confirmez que le service implémente un point de terminaison de liste de modèles. Certaines API n'acceptent qu'un ID de modèle fourni manuellement.
- Supprimez les segments de chemin en double. Une URL racine qui contient déjà
/v1peut échouer lorsque Cherry Studio ajoute un autre/v1. - Vérifiez que vous avez utilisé l'adresse API, et non l'adresse du tableau de bord de gestion du fournisseur.
- Copiez l'ID de modèle exact renvoyé par le fournisseur. Les noms d’affichage et les identifiants API ne sont pas interchangeables.
- Assurez-vous que le fournisseur est activé. Un fournisseur désactivé cache ses modèles au sélecteur.
Erreurs courantes
| Erreur | Cause probable | Premier contrôle |
|---|---|---|
401 Unauthorized | Clé invalide, expirée ou mal formatée | Recopiez la clé et confirmez le profil du protocole |
403 Forbidden | Compte, projet, solde ou limite clé | Vérifier les autorisations et le quota du fournisseur |
404 Not Found | URL racine incorrecte, chemin de version dupliqué ou incompatibilité de protocole | Restaurer l'URL de base documentée |
400 Bad Request | Paramètre ou forme de requête non pris en charge | Supprimez les paramètres personnalisés et réessayez en texte brut |
model not found | Mauvais identifiant ou modèle non ajouté dans Cherry Studio | Copiez l'ID exact du modèle en amont |
| Le texte fonctionne mais les images/outils échouent | Le modèle ou le protocole n'a pas cette capacité | Vérifiez la liste des capacités et l'itinéraire |
| Délai d'attente | Latence du fournisseur, problème de réseau ou demande surdimensionnée | Réessayez avec une courte invite et un modèle |
Modifiez une variable à la fois. Commencez avec un fournisseur, un modèle et une courte demande ; ajoutez ensuite plusieurs modèles ou outils.
Comparer plusieurs modèles
Cherry Studio vous permet de changer de modèle dans le sélecteur de conversation et d'envoyer la même invite à plusieurs modèles sélectionnés. Chaque sélection crée une demande indépendante. C’est utile à des fins de comparaison, mais ce n’est pas un vote automatique ni une garantie de qualité ; le nombre de demandes, le coût et l’exposition des données augmentent avec chaque modèle sélectionné. Le [guide de comparaison officiel] (https://docs.cherryai.com.cn/advanced-basic/chat/model-compare-branches.md) recommande d'écrire des critères d'évaluation explicites au lieu de demander quelle réponse est simplement « la meilleure ».
Utilisez OmniaKey comme fournisseur unique
Si vous ne souhaitez pas conserver de points d'entrée distincts pour GPT, Claude, Gemini et d'autres modèles, configurez OmniaKey en tant que fournisseur personnalisé compatible OpenAI dans Cherry Studio.
- Créez une clé OmniaKey API dédiée et définissez une limite de clé appropriée sur la page Clés API.
- Ouvrez Paramètres → Service de modèle → Ajouter un fournisseur dans Cherry Studio.
- Choisissez le type compatible OpenAI et saisissez l'URL de base et la clé dans le démarrage rapide OmniaKey.
- Récupérez la liste des modèles ou ajoutez un identifiant exact à partir du catalogue de modèles en direct.
- Activez le fournisseur, effectuez une brève vérification et confirmez la demande dans Utilisation.
Le catalogue actuel OmniaKey comprend Claude, GPT, Gemini et Grok, ainsi que des familles de modèles supplémentaires. Les identifiants et les capacités sont dynamiques, utilisez donc le catalogue en direct plutôt qu'un ancien didacticiel. Un itinéraire compatible OpenAI ne rend pas toutes les fonctionnalités spécifiques au fournisseur identiques ; vérifiez la capacité du modèle et du protocole avant d’activer la vision ou les outils.
FAQ
Cherry Studio peut-il utiliser n'importe quel API que je trouve ?
Uniquement lorsque le service expose un protocole pris en charge par Cherry Studio. Une URL arbitraire sans format de requête documenté, méthode d'authentification et ID de modèle ne suffit pas.
Dois-je saisir une URL racine ou /chat/completions ?
Suivez la documentation du fournisseur. Les fournisseurs conventionnels utilisent normalement l'URL racine et laissent Cherry Studio ajouter le chemin de la requête ; utilisez un point de terminaison complet uniquement lorsque le fournisseur l’exige explicitement.
Pourquoi puis-je discuter mais pas utiliser d'outils ou d'images ?
Le succès du texte de base ne prouve pas que le modèle, le protocole et l'itinéraire client sélectionnés prennent en charge les outils ou la vision. Vérifiez chaque capacité séparément.
Un abonnement Web ChatGPT est-il une clé API ?
Non. Cherry Studio nécessite un identifiant de fournisseur API ou un identifiant de passerelle compatible. Les informations de connexion Web ne doivent jamais être collées dans le champ clé API.
Sources et fraîcheur
Ce guide utiliseCherry Studiole fournisseur actuel de, le fournisseur personnalisé,OpenAI, NewAPI et la documentation multimodèle, plusOmniaKeyc'est actuelAPIet la documentation du modèle. Les valeurs techniques telles que les ID de modèle, les capacités du fournisseur et les itinéraires peuvent changer ; vérifiez-les au moment de la configuration.