Cherry Studio

Settings → Model Services → fournisseur personnalisé : collez la clé et l’adresse API, cliquez sur Get Model List, et tout le catalogue remplit le sélecteur.

设置 → 模型服务 → 添加 → 添加自定义提供商 (Settings → Model Services → Add → Add Custom Provider)

  提供商名称 / Provider name    Kunavo
  API 密钥 / API Key            sk-kn-...
  端点设置 / Endpoint settings
    OpenAI                     https://api.kunavo.com/v1
    Anthropic                  https://api.kunavo.com
  → 同步模型 (Sync Models), then add the models you want
  → 检测 (Test) to confirm

Étape par étape

1. Créez une clé sur /app/keys et copiez-la — elle n’est affichée qu’une seule fois.
2. Ouvrez 设置 → 模型服务 (Paramètres → Services de modèles), puis 添加自定义提供商 (Ajouter un fournisseur personnalisé).
3. Renseignez API 密钥 (la clé) et le champ de point de terminaison OpenAI (https://api.kunavo.com/v1).
4. Renseignez aussi le champ Anthropic (https://api.kunavo.com) — il se trouve sous OpenAI dans 端点设置 (Paramètres des points de terminaison). Cherry Agent et tout modèle acheminé via le protocole Anthropic Messages lisent spécifiquement ce champ, et non celui d’OpenAI. Les autres types de points de terminaison se trouvent sous 更多设置 (Plus d’options).
5. Enregistrez, puis cliquez sur 同步模型 dans la liste des modèles du fournisseur et ajoutez les modèles de conversation souhaités ; cliquez sur 检测 pour vérifier l’un d’eux de bout en bout.
6. Attribuez les modèles à chaque assistant plutôt que de les définir globalement : Cherry Studio conserve un modèle par assistant, ce qui permet d’utiliser à la fois un modèle économique par défaut et un modèle spécialisé plus coûteux.

Vérifié avec Documentation de Cherry Studio sur les fournisseurs le 1 octobre 2026. Les paramètres tiers évoluent ; si le nom d’un champ ne correspond plus à ce que vous voyez ici, cette page fait autorité, pas celle-ci.

Vérifiez avant de déboguer le client

Une requête suffit à déterminer si l’échec vient de l’endpoint, de la clé ou du fichier de configuration. Si cette requête renvoie du JSON, la même URL de base et la même clé fonctionnent dans Cherry Studio.

# Settles whether a failure is the endpoint, the key, or the client.
curl -sS https://api.kunavo.com/v1/models \
  -H "Authorization: Bearer sk-kn-..."

Quel identifiant de modèle saisir dans le champ

Tous les modèles textuels sont accessibles sous forme d’identifiant de modèle — la liste à jour se trouve sur GET /v1/models, et le catalogue avec les prix sur la page des modèles. Les tarifs sont en USD par million de tokens, entrée / sortie.