Documentation

Copilot pour Obsidian

L’onglet BYOK de Copilot permet de configurer un fournisseur personnalisé compatible avec OpenAI à l’aide de trois champs. La documentation précise les interfaces auxquelles les modèles ainsi obtenus peuvent accéder ; cette page conserve cette précision au lieu de promettre la prise en charge de l’ensemble du plugin.

Settings → Copilot → BYOK → Add a custom provider : un Display name, votre clé et https://api.kunavo.com/v1 — Quick Chat toujours disponible, Agent Chat sous opencode lorsque le fournisseur y est affiché.

Paramètres → Copilot → BYOK → Ajouter un fournisseur → Ajouter un fournisseur personnalisé

Display name             Kunavo
API key                  sk-kn-...
Base URL                 https://api.kunavo.com/v1
Enable CORS              off — see the note below before turning it on
Model ID → Add           claude-sonnet-5
                         claude-haiku-4-5
Search available models  discovery reads GET /v1/models; typed ids also work
Save                     needs at least one model and a routable endpoint

L’URL de base conserve le suffixe /v1 ici, et la documentation l’établit par des exemples plutôt que par une phrase : elle indique seulement qu’« Un fournisseur personnalisé compatible avec OpenAI doit avoir une URL de base », mais les deux modèles de fournisseur compatible avec OpenAI qu’elle propose par défaut utilisent une URL se terminant par /v1 — http://localhost:11434/v1 pour Ollama et http://localhost:1234/v1 pour LM Studio — et elle ajoute que « La découverte des modèles utilise la réponse /v1/models du point de terminaison ». Si la découverte ne renvoie aucun résultat, c’est la première chose à vérifier.

Un fournisseur BYOK n’est pas accessible depuis toutes les parties du plugin, et la documentation est sans détour : « L’ajout d’une clé ne modifie pas les modèles fournis par Claude Code ou Codex. » Son propre tableau attribue explicitement les modèles BYOK à Quick Chat, et à Agent Chat uniquement avec le moteur opencode, « lorsque le fournisseur y est proposé » — c’est une condition, pas une règle ; de plus, « Un modèle qu’opencode ne peut pas acheminer est exclu de la liste opencode, mais peut tout de même fonctionner dans Quick Chat. » Si vous utilisez le moteur Claude ou Codex, le réglage se trouve plutôt dans l’environnement propre à cette interface CLI : voir /docs/integrations/claude-code.

Activer CORS est un compromis, pas une solution à laisser activée. La documentation indique : « Si le test réussit, mais que Quick Chat ne peut pas envoyer de message, modifiez le fournisseur et activez Activer CORS. Les réponses s’affichent alors une fois la génération terminée, au lieu d’être transmises progressivement, jeton par jeton. » Elle précise aussi que ce réglage ne modifie pas l’acheminement d’opencode ; l’activer pour réparer Quick Chat vous prive donc de l’affichage jeton par jeton dans Quick Chat, et nulle part ailleurs.

Copilot 4.x ne demande aucun fournisseur d’embeddings : sa recherche sémantique est désormais assurée par Miyo, un service distinct, et la boîte de dialogue BYOK ne comporte aucun champ de ce type — tant mieux, car Kunavo ne fournit aucun modèle d’embeddings et cette page ne prétendra pas le contraire.

Kunavo n’a pas testé ce plugin à l’exécution. Tous les champs et toutes les citations ci-dessus proviennent de la documentation de Copilot, consultée à la date indiquée ci-dessous ; une page de configuration publiée ne constitue pas un essai. Envoyez une véritable tâche via Quick Chat avant de lui confier un flux de travail.

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 Copilot pour Obsidian.

Étape par étape

Créez une clé sur /app/keys et copiez-la — elle n’est affichée qu’une seule fois.
Dans Obsidian, ouvrez Settings → Copilot → BYOK et cliquez sur Add a provider.
Choisissez Add a custom provider, plutôt qu’un fournisseur nommé ou qu’un modèle Self Host.
Renseignez Display name, API key et Base URL comme indiqué ci-dessus. Laissez Enable CORS désactivé pour l’instant.
Ajoutez au moins un modèle : saisissez un identifiant sous Model ID → Add ou choisissez-en un dans Search available models, dont la liste est alimentée par GET /v1/models. Cliquez sur Test, puis sur Save ; l’enregistrement est bloqué tant qu’un modèle et un point de terminaison acheminable ne sont pas tous deux présents.
Choisissez où ces modèles apparaissent sous Basic → Agents → Quick Chat et Basic → Agents → opencode, chacun ayant son propre Default model. Les nouveaux modèles de chat sont activés par défaut pour les deux.

Vérifié avec Page Model Sources and BYOK de Copilot le 21 septembre 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 quel moteur Copilot utilise réellement pour payer les jetons.

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 Copilot pour Obsidian.

# 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èle	Entrée / sortie sur Kunavo	Où cela s’intègre dans Copilot pour Obsidian
`claude-haiku-4-5`	$0.70 / $3.50	Quick Chat, où les demandes courtes portant sur une note s’enchaînent toute la journée
`claude-sonnet-5`	$1.40 / $7.00	le moteur opencode dans Agent Chat — le modèle de travail par défaut
`claude-opus-5`	$3.50 / $17.50	une longue synthèse de nombreuses notes, où une mauvaise interprétation coûte cher
`gpt-5-6-sol`	$2.00 / $12.00	un deuxième avis d’une autre famille, avec la même clé et la même ligne de fournisseur

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.

Questions fréquentes

Où saisir une clé API dans Obsidian Copilot ?

Settings → Copilot → BYOK → Add a provider, puis « Add a custom provider » pour un point de terminaison qui ne figure pas dans la liste intégrée. La boîte de dialogue demande un Display name, la clé API, une Base URL, une option Enable CORS facultative et au moins un modèle, ajouté par identifiant ou choisi dans la liste découverte ; cliquez ensuite sur Save. La documentation de Copilot indique que les clés des fournisseurs sont stockées dans le trousseau Obsidian de cet appareil, et non dans le fichier data.json du coffre. La synchronisation d’un coffre ne transfère donc pas les identifiants sur un autre ordinateur.

Faut-il ajouter /v1 à la fin de l’URL de base d’Obsidian Copilot ?

Utilisez la forme /v1 — https://api.kunavo.com/v1 pour Kunavo. La documentation n’énonce pas cette règle en une phrase ; elle précise qu’un fournisseur personnalisé compatible avec OpenAI doit avoir une Base URL, que la découverte des modèles utilise la réponse /v1/models du point de terminaison, et que les deux modèles compatibles avec OpenAI qu’elle propose par défaut utilisent http://localhost:11434/v1 et http://localhost:1234/v1. Les deux valeurs par défaut proposées comportent ce suffixe : c’est l’indication la plus claire que donne la documentation à ce sujet. Une URL de base incorrecte se manifeste généralement par une liste de modèles vide ou par un échec du test, plutôt que par une erreur d’authentification.

Obsidian Copilot peut-il utiliser une passerelle comme OpenRouter ou Kunavo au lieu d’une clé de fournisseur ?

Oui pour Quick Chat, et sous certaines conditions pour Agent Chat. La documentation de Copilot indique que BYOK permet de se connecter « directement à un fournisseur d’IA, à une passerelle compatible ou à un serveur de modèles sur votre ordinateur », et que « Add a custom provider » accepte toute URL de base compatible avec OpenAI ainsi qu’un identifiant de modèle. Son tableau des sources de modèles attribue ensuite explicitement les modèles BYOK à Quick Chat, et à Agent Chat uniquement avec le moteur opencode, « lorsque le fournisseur y est proposé ». Les moteurs Claude et Codex n’acceptent jamais de clé BYOK : la documentation précise que l’ajout d’une clé ne modifie pas les modèles qu’ils fournissent.

Ai-je besoin d’un modèle d’embeddings pour la recherche dans le coffre d’Obsidian Copilot ?

Pas auprès de votre fournisseur de chat. Copilot 4.x n’utilise plus son propre index dans le plugin : la documentation indique que la recherche sémantique et Relevant Notes sont fournis par Miyo, un service distinct, local ou distant, et que la boîte de dialogue BYOK ne comporte aucun champ pour ce type de modèle. Kunavo ne fournit pas non plus de modèle d’embeddings : rien ici ne doit être interprété comme une offre de ce type. Dans Copilot, une ligne de fournisseur de chat paie le chat, et rien d’autre.

Une clé Kunavo remplace-t-elle une licence Copilot Lite ou Plus ?

Non, et les deux constituent délibérément des lignes distinctes. La documentation de Copilot traite la licence et BYOK comme des sources de modèles différentes : une licence fournit des modèles hébergés par Copilot, facturés par Brevilabs selon votre forfait, tandis que BYOK envoie les requêtes à votre propre point de terminaison, la facturation restant à la charge de ce fournisseur. Une clé ici ne recharge pas le quota de licence, ne débloque pas les lignes Copilot hébergées qui sont verrouillées et ne modifie pas les services soumis à licence ; à l’inverse, vous pouvez utiliser BYOK avec l’offre gratuite sans aucune licence.