Documentation

Documentation

Msty Studio

La documentation de Msty Studio indique qu’un point de terminaison compatible avec OpenAI peut être ajouté comme fournisseur, puis s’arrête là. L’application elle-même donne plus de précisions : elle indique le type de fournisseur, les deux champs et la règle concernant /v1. Voici le formulaire rempli pour Kunavo.

Model Hub > Model Providers > Add Provider > Open AI Compatible : une API Key et un Inference Endpoint de https://api.kunavo.com/v1 — la note de l’application indique que la plupart des endpoints compatibles OpenAI nécessitent /v1.

Msty Studio 2.9.11 — Ajouter un fournisseur
Model Hub  >  Model Providers  >  Add Provider

Provider             Open AI Compatible     (under "OpenAI Compatible")
Name                 Kunavo                 "Give it a name (optional)"
API Key              sk-kn-...
Inference Endpoint   https://api.kunavo.com/v1      <- keep the /v1

Models               Fetch Models, then tick the ids you want
                     (or Add Custom Model: Model ID + Model Name)
                                                     → Save Provider
Conservez /v1 : Msty le précise lui-même. Sous le champ Inference Endpoint, l’application indique : « La plupart des points de terminaison des fournisseurs compatibles avec OpenAI nécessitent le chemin /v1, par exemple https://example.com/v1. » Msty Studio ajoute uniquement /models et /chat/completions à votre saisie. Sans /v1, Fetch Models envoie une requête à https://api.kunavo.com/models et les demandes de chat sont envoyées à https://api.kunavo.com/chat/completions ; depuis le 1er octobre 2026, les deux renvoient une erreur 404 au format JSON dont le message indique d’ajouter /v1 (auparavant, la récupération des modèles lisait une page Web).
Origine de ces libellés. La documentation en ligne de Msty ne nomme pas les champs. Les libellés ci-dessus sont ceux intégrés à la version de bureau 2.9.11 de Msty Studio (téléchargée depuis les serveurs de Msty le 1er octobre 2026 et consultée sans lancer l’application) ; ils correspondent donc à ceux affichés en anglais. Une version ultérieure peut les reformuler ; l’application sur votre écran fait foi.
Pas de test de bout en bout. Personne ici n’a envoyé de message de Msty Studio à Kunavo. Le formulaire du fournisseur, la note sur /v1 et les chemins des requêtes ont été relevés dans la version publiée ; le côté Kunavo a été vérifié à l’aide de simples requêtes HTTP. Le streaming, les appels d’outils, les entrées d’images et les commandes de réflexion via ce type de fournisseur n’ont pas été testés : votre premier chat constituera la véritable vérification.
Pas encore de clé ? Créez un compte Kunavo, créez une clé (elle commence par sk-kn-) et ajoutez un crédit à partir de 10 $ — les appels sont payés sur ce solde et les appels échoués ne sont pas facturés. Le tableau de bord s’ouvre ensuite sur la configuration Msty Studio.

Étape par étape

  1. Créez une clé sur /app/keys et copiez-la — elle n’est affichée qu’une seule fois.
  2. Dans Msty Studio, ouvrez Model Hub > Model Providers et choisissez Add Provider. Dans la liste des fournisseurs, sous l’en-tête OpenAI Compatible, choisissez Open AI Compatible, et non OpenAI, qui est le fournisseur OpenAI intégré.
  3. Donnez-lui un nom, collez la clé dans API Key et saisissez https://api.kunavo.com/v1 dans Inference Endpoint. L’application exige que l’URL commence par https://.
  4. Cliquez sur Fetch Models et cochez les modèles souhaités. Kunavo répond à GET /v1/models en renvoyant le catalogue complet ; sélectionnez-en donc quelques-uns plutôt que tous. Si vous préférez, ouvrez Add Custom Model et saisissez un Model ID exactement comme il apparaît dans le catalogue, par exemple claude-sonnet-5.
  5. Cliquez sur Save Provider, puis ouvrez une conversation et sélectionnez l’un de ses modèles : c’est l’étape de test indiquée dans la documentation de Msty. Si vous obtenez une réponse, le point de terminaison, la clé et l’identifiant du modèle sont corrects.

Vérifié avec Page Online Providers de Msty Studio 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.

Voici la version courte. Le guide complet — choix du modèle, coût d’une session réelle et modes d’échec — se trouve dans Tarifs de Msty Studio et coût de l’API.

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 Msty 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.

Identifiant du modèleEntrée / sortie sur KunavoOù cela s’intègre dans Msty Studio
claude-sonnet-5$1.40 / $7.00Longs documents et conversations Knowledge Stack : le modèle à utiliser par défaut dans la plupart des conversations
gpt-5-6-terra$0.70 / $4.20Une deuxième famille dans un volet de comparaison de conversations parallèles
claude-haiku-4-5$0.70 / $3.50Questions rapides, titres et tâches que vous exécutez fréquemment
La facturation se fait au token à partir d’un solde prépayé, sans frais mensuels — consultez la facturation. Avec un contexte répété — ce qu’envoient la plupart des éditeurs et clients de chat — la mise en cache des prompts influe davantage sur la facture que le choix du modèle.

De quel Msty s’agit-il ?

  • Msty Studio — l’environnement de travail de bureau et Web concerné par cette page, avec les fournisseurs dans Model Hub > Model Providers.
  • Msty Go — une application d’agent distincte, avec son propre écran de fournisseur sous Settings ; sa configuration est expliquée sur sa propre page.
  • Msty 1.x — l’application retirée du marché, dont l’ancienne documentation sur docs.msty.app apparaît toujours dans les résultats. Ses écrans ne sont pas ceux de Studio.

Ce que l’application indique en cas d’échec

Voici les messages intégrés à la version 2.9.11 et leur signification pour ce point de terminaison :

  • « Le point de terminaison du fournisseur est introuvable. Vérifiez l’URL du point de terminaison et assurez-vous qu’elle inclut le chemin d’API approprié, par exemple /v1. » — le champ Inference Endpoint ne contient pas /v1.
  • « Impossible de se connecter au point de terminaison du fournisseur… » — le nom d’hôte comporte une faute de frappe, ou http:// se trouve à la place de https://.
  • Fetch Models échoue alors que l’URL est correcte — vérifiez la clé. La liste de modèles de Kunavo nécessite une clé valide et renvoie une erreur 401 sans clé.
  • Un modèle apparaît dans la liste, mais une conversation échoue — le formulaire de Msty avertit que « Tous les modèles n’ont pas été testés avec Msty ». La liste de Kunavo comprend des modèles d’images, de vidéos et d’audio qu’une fenêtre de chat ne peut pas utiliser ; choisissez un modèle de chat.

Ce qui quitte votre machine

Msty présente les fournisseurs en ligne comme un moyen « d’utiliser des modèles hébergés avec vos clés API, sans exécuter l’inférence du modèle sur votre appareil ». Ainsi, une conversation utilisant un modèle Kunavo envoie son prompt et son contexte joint à Kunavo, qui les transmet au fournisseur du modèle ; une conversation utilisant un modèle local ne le fait pas. Si cette distinction est importante pour vous, conservez les données sensibles dans des modèles locaux.

Niveau de réflexion pour ce type de fournisseur

La documentation de Msty indique que les « modèles compatibles avec OpenAI » prennent uniquement en charge les niveaux de réflexion None et Default, tandis que son fournisseur Anthropic natif propose Think Lightly, Moderately et Deeply. Avec le type Open AI Compatible, attendez-vous à ce qu’un modèle Claude utilise son niveau de raisonnement par défaut plutôt qu’un niveau réglable.

Questions fréquentes

Comment ajouter un fournisseur personnalisé compatible avec OpenAI dans Msty Studio ?

Ouvrez Model Hub > Model Providers et choisissez Add Provider. Sous l’en-tête OpenAI Compatible, sélectionnez Open AI Compatible, donnez un nom au fournisseur, collez votre clé dans API Key et saisissez le point de terminaison dans Inference Endpoint, chemin de version compris — pour Kunavo, https://api.kunavo.com/v1. Cliquez sur Fetch Models pour charger la liste ou utilisez Add Custom Model pour saisir un Model ID, puis cliquez sur Save Provider. Ces libellés sont ceux de la version 2.9.11 de Msty Studio ; la documentation en ligne de Msty décrit la même procédure sans nommer les champs.

Msty Studio exige-t-il /v1 dans le point de terminaison ?

Pour la plupart des fournisseurs compatibles avec OpenAI, oui, et l’application le précise elle-même : sous le champ Inference Endpoint, elle affiche « La plupart des points de terminaison des fournisseurs compatibles avec OpenAI nécessitent le chemin /v1, par exemple https://example.com/v1. Si vous rencontrez des problèmes, essayez d’ajouter /v1 au point de terminaison. » Msty Studio ajoute uniquement /models et /chat/completions ; le point de terminaison de Kunavo est donc https://api.kunavo.com/v1. Sans /v1, la récupération des modèles comme les conversations renvoient une erreur 404 dont le message indique d’ajouter /v1.

Le fournisseur personnalisé de Msty Studio est-il le même que celui de Msty Go ?

Non. Ce sont deux applications distinctes, avec des écrans de configuration des fournisseurs séparés. Dans Msty Studio, ajoutez les fournisseurs dans Model Hub > Model Providers en choisissant le type Open AI Compatible décrit ici. Msty Go, l’application d’agents anciennement appelée Msty Claw, configure les fournisseurs dans Settings > Model Providers avec ses propres champs. Les instructions de configuration de l’une ne s’appliquent pas à l’autre, et aucune des deux ne correspond à l’ancienne application Msty 1.x, aujourd’hui abandonnée, dont l’ancienne documentation apparaît encore dans les résultats de recherche.

Qui me facture lorsque Msty Studio utilise un fournisseur personnalisé ?

Deux parties, séparément. Msty facture le niveau de l’application que vous utilisez, le cas échéant. Les appels au modèle sont facturés par l’émetteur de la clé renseignée dans le champ API Key du fournisseur — avec une clé Kunavo, le coût est calculé par jeton et débité du solde prépayé Kunavo. Les modèles locaux exécutés dans Msty ne coûtent rien par requête. Les niveaux et le coût d’une conversation type sur un long document aux tarifs du catalogue sont détaillés sur la page de tarification de Msty Studio liée ci-dessus.

Kunavo a-t-il testé Msty Studio ?

Pas de bout en bout. Le 1er octobre 2026, la version officielle pour ordinateur de Msty Studio 2.9.11 a été téléchargée depuis les serveurs de Msty et consultée sans être lancée : le type de fournisseur, les libellés des champs, la note /v1, les messages d’erreur et les chemins de requête présentés sur cette page en proviennent. Le côté Kunavo a été vérifié par des requêtes HTTP directes. Aucun échange entre Msty Studio et Kunavo n’a été effectué ; la diffusion en continu, l’utilisation d’outils et l’entrée d’images via ce fournisseur ne sont donc pas vérifiées.