Dans Cherry Studio, le chemin de configuration de l’API est Settings → Model Provider → Add Provider. Saisissez API Key, indiquez l’adresse racine dans les champs OpenAI et Anthropic de Endpoint settings, enregistrez, puis importez les modèles avec « Sync models » et vérifiez-en un avec « Check ». À savoir d’abord : Cherry Studio ne possède pas d’interface coréenne ; les menus sont donc repris tels quels en anglais. Cette page se base sur la v2.1.4 publiée le 30 septembre 2026. L’écran d’ajout d’un fournisseur ayant été profondément modifié dans la v2, l’explication de l’époque de la v1, « Type: OpenAI », ne correspond plus à l’interface actuelle.
La cible est la version pour ordinateur de CherryHQ/cherry-studio (AGPL-3.0, Windows·macOS·Linux). Au 1er octobre 2026, le dépôt n’est pas archivé et la dernière version est la v2.1.4. L’application du même nom sur l’App Store est une application indépendante d’un autre développeur. L’interface intégrée propose 13 langues et pas le coréen (d’après les fichiers de traduction de l’interface de v2.1.4) ; les instructions supposent donc l’utilisation de l’interface anglaise.
Configuration étape par étape
Settings → Model Provider → Add Provider
(대화상자 제목: Add Custom Provider)
Provider Name Kunavo
API Key sk-kn-...
Endpoint settings
OpenAI https://api.kunavo.com/v1
Anthropic https://api.kunavo.com
More options
OpenAI Responses https://api.kunavo.com/v1 (선택)
Image Generation Base URL https://api.kunavo.com/v1 (선택)
Gemini 비워 둠
→ Save → 모델 목록에서 "Sync models" → 쓸 모델 추가 → "Check"- Dans Settings → Model Provider, cliquez sur Add Provider. La boîte de dialogue qui s’ouvre s’intitule « Add Custom Provider ». Si vous avez besoin d’un service de type Coding Plan, de plusieurs comptes ou d’une séparation entre projets, vous pouvez également commencer avec un préréglage existant via « Start from a preset (optional) », en haut.
- Saisissez Provider Name et API Key.
- Endpoint settings contient dès le départ deux champs : OpenAI et Anthropic. Au moins un point de terminaison texte est requis (s’ils sont tous deux vides, l’erreur « Configure at least one text endpoint » s’affiche). Si vous remplissez les deux champs, vous pourrez choisir des modèles non seulement pour le chat, mais aussi pour les fonctions Agent et celles qui utilisent le format Anthropic.
- En développant More options, vous trouverez les champs OpenAI Responses, Gemini, Image Generation Base URL et Image Edit Base URL. Laissez vides les champs que vous n’utilisez pas.
- Après l’enregistrement, vérifiez que le fournisseur est activé (Enable). Selon la documentation officielle, un fournisseur configuré mais non activé n’apparaît pas dans la liste de sélection des modèles. C’est la cause la plus fréquente du message « la clé ne fonctionne pas ».
- Dans la liste des modèles, utilisez Sync models pour importer les modèles, ajoutez celui que vous souhaitez utiliser, puis vérifiez-en un avec Check.
Comment saisir l’adresse : uniquement l’adresse racine
D’après le code source de v2.1.4, saisissez l’adresse racine dans chaque champ. Si la partie version est absente, /v1 est ajoutée automatiquement (et ne l’est pas si elle est déjà présente), puis le chemin fixe propre au champ est ajouté. L’URL finale est affichée sous chaque champ avec « Request path » ; vérifiez-la avant d’enregistrer.
| Champ | Chemin ajouté par Cherry Studio | Kunavo |
|---|---|---|
| OpenAI | /chat/completions | Prise en charge |
| Anthropic | /messages | Prise en charge |
| OpenAI Responses (More options) | /responses | Prise en charge |
| Image Generation Base URL (More options) | /images/generations | Prise en charge |
| Image Edit Base URL (More options) | /images/edits | Prise en charge |
| Gemini (More options) | /models/{model}:generateContent | Non pris en charge, laisser vide |
Il existe deux erreurs courantes. Si vous collez l’URL complète incluant /chat/completions ou /messages, le chemin est ajouté deux fois et provoque une erreur 404. De plus, le # final est, comme l’indique l’interface, le symbole qui « Add # at the end to disable the automatically appended API version », c’est-à-dire qui désactive l’ajout automatique de la version ; si vous l’ajoutez à un point de terminaison standard, /v1 est omis. Pour vérifier rapidement l’adresse et la clé elles-mêmes, utilisez la commande ci-dessous.
curl https://api.kunavo.com/v1/models \
-H "Authorization: Bearer $KUNAVO_API_KEY"Configuration de modèles de base pour réduire les coûts
Cherry Studio appelle des modèles en arrière-plan, en plus du chat. Quick Model sert, comme l’indique l’interface, aux « tâches simples comme nommer les conversations et extraire les mots-clés de recherche », qui recommandent également de « choisir un modèle léger et d’éviter les modèles de raisonnement ». En y configurant un modèle peu coûteux, vous évitez d’exécuter un modèle cher à chaque conversation. Configurez également Translate Model séparément. Si vous sélectionnez plusieurs modèles et leur posez une question en une seule fois, une requête distincte est envoyée et facturée pour chacun. Le montant affiché dans les statistiques d’utilisation de l’application est une estimation convertie à partir des prix publics ; avec un chemin bénéficiant d’une remise, il sera donc supérieur au montant réel. Modifiez les tarifs unitaires dans la configuration des modèles pour obtenir un montant exact. Pour plus de détails, consultez la page en anglais Cherry Studio API cost.
Points d’attention et paiement avec Kunavo
- Portée de la vérification : cette configuration a été rédigée à partir du code source et de la documentation officielle de Cherry Studio ; Kunavo n’a pas vérifié en exécutant réellement Cherry Studio connecté à ses propres points de terminaison. Conservez le chemin actuellement utilisé et testez-le.
- Chat et images uniquement : Kunavo ne propose pas de modèles d’embeddings ; la recherche vectorielle dans une base de connaissances nécessite donc un autre fournisseur ou un modèle d’embeddings local. La documentation officielle précise que, même sans modèle d’embeddings, la base de connaissances fonctionne avec une recherche par mots-clés BM25.
- Outils MCP : les outils ajoutés dans Settings → MCP Servers nécessitent un modèle prenant en charge les appels d’outils. Les modèles Claude et GPT ajoutés ci-dessus sont compatibles.
- Paiement : recharge prépayée sans abonnement mensuel, le solde étant débité à l’unité de token. Le montant minimal de recharge est de $10, et le paiement Stripe accepte les cartes (Visa, Mastercard, American Express, JCB, UnionPay), Apple Pay, Google Pay et Link. Si le paiement s’affiche en wons coréens, KakaoPay, Naver Pay, PAYCO, Samsung Pay et les cartes nationales bloquant les paiements internationaux sont également proposés (ajouté le 2026-10-03, aucun paiement n’a encore été effectué avec ces moyens). Les montants sont définis en dollars et l’affichage en wons est converti par Stripe ; le taux de change inclut des frais de conversion de 2–4 % à la charge du payeur. Toss Pay n’est pas disponible. Consultez les informations de paiement et créez un compte pour obtenir une clé. La page de configuration en anglais est le guide d’intégration de Cherry Studio.
Questions fréquentes
Comment configurer l’API dans Cherry Studio ?
Cliquez sur Settings → Model Provider → Add Provider pour ouvrir la boîte de dialogue « Add Custom Provider ». Saisissez Provider Name et API Key, puis indiquez l’adresse racine dans les champs OpenAI et Anthropic de Endpoint settings avant d’enregistrer. Ensuite, utilisez « Sync models » dans la liste des modèles pour importer les modèles, ajoutez celui que vous souhaitez utiliser et vérifiez-en un avec « Check ». Le fournisseur doit être activé (Enable) pour que les modèles apparaissent dans la liste de sélection.
Cherry Studio peut-il être utilisé en coréen ?
L’interface ne prend pas en charge le coréen. Dans v2.1.4, les 13 langues de l’interface sont l’anglais, le chinois (simplifié et traditionnel), le japonais, l’allemand, le français, l’espagnol, le portugais, le russe, le grec, le roumain, le turc et le vietnamien. Comme les menus sont souvent utilisés en anglais, cette page reprend les noms anglais des menus tels quels. Les conversations avec les modèles peuvent bien sûr se faire en coréen.
Faut-il ajouter /v1 à l’adresse de l’API ?
Les deux sont possibles. Le code source de v2.1.4 ajoute automatiquement la version (/v1) à l’adresse racine saisie si elle n’y figure pas, et la conserve si elle est déjà présente, puis ajoute le chemin propre à chaque champ (OpenAI : /chat/completions, Anthropic : /messages). Il faut éviter de coller l’URL complète incluant /chat/completions, car le chemin serait ajouté deux fois et provoquerait une erreur 404. Le caractère # final désactive l’ajout automatique de la version ; ne l’utilisez donc pas avec les points de terminaison standard. Vous pouvez vérifier l’URL finale dans « Request path », sous chaque champ.
Que faire si aucun modèle n’apparaît après avoir cliqué sur Sync models ?
Ce bouton demande la liste des modèles du fournisseur (/v1/models) avec l’adresse et la clé saisies ; si la liste est vide, le problème vient généralement de l’adresse ou de la clé. Vérifiez que vous n’avez pas collé l’URL complète et qu’il n’y a pas de # final, puis essayez d’exécuter curl avec la même adresse et la même clé. Si vous obtenez du JSON, le problème vient de l’application ; si vous obtenez 401, il vient de la clé.
Cherry Studio est-il gratuit ?
La version communautaire pour ordinateur est gratuite, car elle est open source sous licence AGPL-3.0. Ce qui est payant, ce sont les frais d’utilisation des modèles du fournisseur configuré. Cherry Studio Enterprise est un produit distinct sur devis, et CherryAI intégré est gratuit, mais sa configuration de modèles et ses limites ne sont pas publiées.
Vérification effectuée le 1er octobre 2026 : API GitHub (CherryHQ/cherry-studio, v2.1.4), liste des fichiers de traduction de l’interface de v2.1.4 et chaînes de l’interface anglaise (en-us.json), code source de l’écran d’ajout d’un fournisseur et documentation officielle de Cherry Studio. Kunavo n’a pas exécuté Cherry Studio avec ses propres points de terminaison.