Documentazione

Copilot for Obsidian

La scheda BYOK di Copilot consente di configurare un provider compatibile con OpenAI usando tre campi. La documentazione è precisa su quali interfacce possono usare i modelli così configurati; questa pagina mantiene la stessa precisione, senza fare promesse sull’intero plugin.

Settings → Copilot → BYOK → Add a custom provider: un Display name, la tua chiave e https://api.kunavo.com/v1 — Quick Chat sempre disponibile, Agent Chat in opencode quando il provider viene mostrato lì.

Settings → Copilot → BYOK → Add a provider → Add a custom provider

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

Qui l’URL di base mantiene il suffisso /v1; la documentazione lo chiarisce con gli esempi, non con una frase esplicita: afferma soltanto che «Un provider personalizzato compatibile con OpenAI deve avere un URL di base», ma entrambi i modelli OpenAI-compatible inclusi hanno come URL predefinito uno che termina con /v1: http://localhost:11434/v1 per Ollama e http://localhost:1234/v1 per LM Studio. Inoltre, specifica che «La ricerca dei modelli usa la risposta /v1/models dell’endpoint». Se la ricerca non restituisce risultati, è questa la prima cosa da ricontrollare.

Un provider BYOK non è disponibile in ogni parte del plugin e la documentazione lo dice chiaramente: «L’aggiunta di una chiave non cambia i modelli forniti da Claude Code o Codex.» La tabella del plugin assegna i modelli BYOK direttamente a Quick Chat e ad Agent Chat solo con il backend opencode, «quando il provider viene mostrato lì»: è una condizione, non una regola. Inoltre, «Un modello che opencode non riesce a instradare viene escluso dall’elenco di opencode, ma può comunque funzionare in Quick Chat.» Se usi il backend Claude o Codex, devi intervenire sull’ambiente del rispettivo CLI; vedi /docs/integrations/claude-code.

Abilitare CORS è un compromesso, non una correzione da lasciare attiva. La documentazione dice: «Se Test va a buon fine ma Quick Chat non riesce a inviare un messaggio, modifica il provider e attiva Enable CORS. Le risposte compariranno al termine dell’elaborazione, anziché arrivare in streaming, token per token.» Specifica inoltre che l’interruttore non modifica l’instradamento di opencode; quindi attivarlo per sistemare Quick Chat fa perdere l’output token per token lì, ma non altrove.

Copilot 4.x non richiede un provider di embedding: la ricerca semantica è stata spostata in Miyo, un servizio separato, e la finestra BYOK non contiene quel campo. È un bene, perché Kunavo non offre modelli di embedding e questa pagina non ne suggerirà la disponibilità.

Kunavo non ha testato questo plugin durante l’esecuzione. Tutti i campi e le citazioni riportati sopra sono stati ricavati dalla documentazione di Copilot alla data indicata sotto; una pagina di configurazione pubblicata non è una prova pratica. Prima di trasferirvi un flusso di lavoro, esegui un’attività reale con Quick Chat.

Non hai ancora una chiave? Crea un account Kunavo, genera una chiave (inizia con sk-kn-) e aggiungi credito da $10: le chiamate vengono pagate con quel saldo e le chiamate non riuscite non vengono addebitate. La dashboard si apre quindi sulla configurazione Copilot for Obsidian.

Passo dopo passo

Crea una chiave su /app/keys e copiala: viene mostrata una sola volta.
In Obsidian, apri Settings → Copilot → BYOK e fai clic su Add a provider.
Scegli Add a custom provider, anziché un provider con nome o un modello Self Host.
Compila Display name, API key e Base URL come sopra. Per ora, lascia disattivato Enable CORS.
Aggiungi almeno un modello: inserisci un ID in Model ID → Add oppure selezionane uno da Search available models, che viene compilato a partire da GET /v1/models. Fai clic su Test, quindi su Save; il salvataggio è bloccato finché non sono presenti sia un modello sia un endpoint instradabile.
Scegli dove mostrare i modelli da Basic → Agents → Quick Chat e Basic → Agents → opencode, ciascuno con il proprio Default model. Per impostazione predefinita, i nuovi modelli di chat sono abilitati per entrambi.

Verificato rispetto a La pagina Model Sources e BYOK di Copilot il 21 settembre 2026. Le impostazioni di terze parti cambiano; se il nome di un campo qui non corrisponde più a quello visualizzato, fa fede quella pagina, non questa.

Questa è la versione breve. La guida completa, con scelta del modello, costo di una sessione reale e modalità di errore, è in quale backend di Copilot usa effettivamente i token.

Verifica prima di eseguire il debug del client

Una sola richiesta stabilisce se il problema riguarda l'endpoint, la chiave o il file di configurazione. Se restituisce JSON, lo stesso base URL e la stessa chiave funzionano in Copilot for 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-..."

Quale model id inserire nel campo

Ogni modello di testo è raggiungibile come model id: l'elenco aggiornato è GET /v1/models e il catalogo con i prezzi è nella pagina dei modelli. Le tariffe sono in USD per 1M di token, input / output.

ID del modello	Kunavo ingresso / uscita	Dove si inserisce in Copilot for Obsidian
`claude-haiku-4-5`	$0.70 / $3.50	Quick Chat, dove le domande brevi su una nota si susseguono per tutto il giorno
`claude-sonnet-5`	$1.40 / $7.00	il backend opencode in Agent Chat: il modello di lavoro predefinito
`claude-opus-5`	$3.50 / $17.50	sintesi estese di molte note, dove un’interpretazione errata costa cara
`gpt-5-6-sol`	$2.00 / $12.00	un secondo parere da un’altra famiglia, con la stessa chiave e la stessa riga del provider

La fatturazione è per token, usando un saldo prepagato senza canone mensile: vedi billing. In presenza di contesto ripetuto, che costituisce la maggior parte di ciò che invia un editor o un client di chat, prompt caching incide sulla spesa più della scelta del modello.

Domande frequenti

Dove inserisco una chiave API in Obsidian Copilot?

Settings → Copilot → BYOK → Add a provider, poi «Add a custom provider» per un endpoint che non è nell’elenco integrato. La finestra richiede un Display name, la chiave API, un Base URL, l’interruttore opzionale Enable CORS e almeno un modello, aggiunto tramite ID o selezionato dall’elenco individuato, quindi consente di salvare. La documentazione di Copilot afferma che le chiavi dei provider vengono conservate nel Portachiavi di Obsidian del dispositivo, anziché nel file data.json del vault; perciò, sincronizzare un vault non trasferisce la credenziale su un altro computer.

L’URL di base di Obsidian Copilot deve terminare con /v1?

Usa il formato /v1: per Kunavo, https://api.kunavo.com/v1. La documentazione non enuncia la regola in una frase: specifica che un provider personalizzato compatibile con OpenAI deve avere un Base URL, che la ricerca dei modelli usa la risposta /v1/models dell’endpoint e che i due template compatibili con OpenAI inclusi hanno come URL predefiniti http://localhost:11434/v1 e http://localhost:1234/v1. Entrambi gli URL predefiniti inclusi hanno il suffisso, ed è l’indicazione più chiara fornita dalla documentazione. Un URL di base errato si manifesta di solito con un elenco di modelli vuoto o un Test non riuscito, anziché con un errore di autenticazione.

Obsidian Copilot può usare un gateway come OpenRouter o Kunavo al posto della chiave di un fornitore?

Sì per Quick Chat e, a determinate condizioni, per Agent Chat. La documentazione di Copilot descrive BYOK come un modo per connettersi «direttamente a un provider di IA, a un gateway compatibile o a un server modello sul proprio computer»; inoltre, «Add a custom provider» accetta qualsiasi URL di base compatibile con OpenAI e un ID modello. La tabella delle origini dei modelli assegna poi i modelli BYOK a Quick Chat direttamente e ad Agent Chat solo con il backend opencode, «quando il provider viene mostrato lì». I backend Claude e Codex non accettano mai una chiave BYOK: la documentazione afferma che aggiungere una chiave non cambia i modelli che forniscono.

Mi serve un modello di embedding per la ricerca nel vault di Obsidian Copilot?

Non dal tuo provider di chat. Copilot 4.x non gestisce più un indice interno al plugin: la documentazione afferma che la ricerca semantica e Relevant Notes sono fornite da Miyo, un servizio locale o remoto separato; inoltre, la finestra BYOK non contiene un campo per quel tipo di modello. Kunavo non offre modelli di embedding, quindi nulla di quanto riportato qui va interpretato come un’offerta in tal senso: una riga del provider di chat in Copilot serve a pagare la chat, e nient’altro.

Una chiave Kunavo sostituisce una licenza Copilot Lite o Plus?

No, e le due opzioni sono volutamente separate. La documentazione di Copilot tratta la licenza e BYOK come origini di modelli diverse: una licenza fornisce modelli ospitati da Copilot, fatturati da Brevilabs in base al tuo piano, mentre BYOK invia le richieste al tuo endpoint, e la fatturazione resta a carico di quel provider. Una chiave qui non ricarica la quota della licenza, non sblocca i modelli Copilot ospitati e bloccati e non modifica i servizi accessibili solo con licenza; viceversa, puoi usare BYOK con il piano gratuito, senza alcuna licenza.