Cherry Studio

Cherry Studio se connecte avec un Provider OpenAI compatible et la Base URL /v1.

Avant de configurer

• Cette page utilise seulement des espaces réservés. Copiez la vraie Key depuis les clés API PopGo et le modèle depuis les modèles et tarifs.
• La configuration en un clic concerne les logiciels déjà installés avec un gestionnaire de protocole enregistré. Autorisez le navigateur à ouvrir l’application externe quand il le demande.
• En configuration manuelle, enregistrez d’abord un Provider minimal. Activez streaming, outils ou routage multi-modèles après le premier succès.

Source officielle et vérification

Cette page a été vérifiée le 2026-07-13 avec la source officielle de Cherry Studio 1.9.12. Source officielle. La vérification couvre la configuration du Provider personnalisé de Cherry Studio.

Configuration en un clic

Connectez-vous à la page des clés PopGo API et ouvrez le menu d'actions de la ligne Key visée. La documentation publique ne crée ni n'affiche de lien contenant une Key. Ouvrez le sous-menu Chat, puis choisissez Cherry Studio. Après l'import, confirmez le format OpenAI compatible et choisissez un modèle disponible.

Configuration manuelle

Sélectionnez un Provider OpenAI compatible puis remplissez les champs ci-dessous.

Champ	Valeur
Type de Provider	OpenAI compatible
Base URL	https://api.popgo.site/v1
API Key	YOUR_API_KEY
Model	YOUR_MODEL

Configuration en texte

1. Installez ou mettez à jour Cherry Studio, puis ouvrez « Settings → Model services ».
2. Créez un Provider personnalisé et choisissez OpenAI compatible. Ne modifiez pas le Provider officiel intégré.
3. Saisissez https://api.popgo.site/v1 comme Base URL, YOUR_API_KEY comme API Key et YOUR_MODEL comme Model.
4. Enregistrez, créez une nouvelle conversation et envoyez un court message. Activez ensuite les images, vidéos, outils ou longs contextes.
5. Créez des Providers séparés pour les différents protocoles ou familles de modèles afin de ne pas mélanger les adresses.

Symptômes fréquents

• Une liste de modèles vide ne signifie pas forcément un échec. Saisissez YOUR_MODEL manuellement si le client ne récupère pas les modèles tiers.
• Si le service par défaut est encore utilisé, sélectionnez le nouveau Provider, fermez l’ancienne conversation et redémarrez le client.
• Si une nouvelle capacité manque dans une ancienne version, mettez le client à jour et suivez les champs de l’interface actuelle.

Critère de réussite

Envoyez un court message depuis le test de modèle ou une nouvelle conversation ; une réponse confirme la réussite.

Erreurs courantes et récupération

• Si le test échoue, vérifiez que /v1 n'est pas dupliqué à la fin de la Base URL.
• Pour un statut 401, recollez YOUR_API_KEY après avoir retiré les espaces.
• Pour un statut 404, vérifiez le niveau de Base URL et que le client n'ajoute pas /v1 deux fois.