Ressources pour développeurs

Cherry Studio

Connectez Cherry Studio à RunAPI et vérifiez un chat.

Connectez Cherry Studio à RunAPI avec un fournisseur OpenAI personnalisé. Créez une clé API RunAPI standard dans le Guide d’authentification avant de continuer.

Installer Cherry Studio

Installez l’application de bureau en suivant le guide de téléchargement officiel de Cherry Studio, puis ouvrez ses paramètres.

Ajouter le fournisseur RunAPI

Ouvrez Settings -> Model Services -> + Add.
Définissez le nom du fournisseur sur RunAPI et le Provider type sur OpenAI.
Saisissez votre clé API RunAPI et définissez l’adresse API sur https://runapi.ai/v1.
Ajoutez un identifiant de modèle précis depuis le Catalogue de modèles, activez le fournisseur et enregistrez.

Étant donné que le type de fournisseur est OpenAI, ce champ utilise l’URL de base compatible OpenAI de RunAPI, qui inclut /v1. Cherry Studio ajoute /chat/completions pour une requête Chat Completions ; ne collez donc pas l’URL complète de l’opération dans le champ adresse API.

Sélectionner un modèle

Les fournisseurs personnalisés dépendent des modèles que vous ajoutez. Si le sélecteur est vide, revenez à la zone de gestion des modèles du fournisseur et ajoutez manuellement un identifiant RunAPI exact. L’ajout d’un modèle n’accorde pas de capacités que le modèle ne prend pas en charge.

Exécuter la vérification de connexion

Exécutez Vérification de la connexion avec le modèle enregistré. Cela envoie une requête au modèle plutôt que de simplement valider le format de la clé. Une vérification réussie confirme que l’URL du fournisseur, la clé et le modèle sélectionné fonctionnent ensemble.

Vérifier la connexion

Démarrez un nouveau chat, sélectionnez le fournisseur et le modèle RunAPI, puis envoyez Reply with the word connected. Une réponse complète ou en streaming normale confirme que le chat actif utilise RunAPI.

Résoudre les problèmes

Le sélecteur de modèles est vide : ajoutez l’identifiant de modèle exact dans la zone de gestion des modèles du fournisseur personnalisé et confirmez que le fournisseur est activé.
La vérification de connexion échoue : confirmez qu’un modèle est sélectionné, remplacez la clé par une clé standard valide et réessayez.
La requête retourne 404 : utilisez https://runapi.ai/v1 comme adresse API ; n’ajoutez pas /chat/completions vous-même.
Text fonctionne mais la vision ou les outils échouent : choisissez un modèle qui déclare la capacité requise dans le Catalogue de modèles.

Pour le comportement de protocole partagé, utilisez le démarrage rapide de l’API LLM . Pour les champs de requête et de réponse, consultez la référence de l’API Chat Completions .