Documentación

Copilot para Obsidian

La pestaña BYOK de Copilot permite añadir un proveedor personalizado compatible con OpenAI mediante tres campos. La documentación especifica con precisión en qué partes se pueden usar los modelos resultantes, y esta página conserva esa precisión en lugar de hacer promesas sobre todo el complemento.

Settings → Copilot → BYOK → Add a custom provider: un Display name, tu clave y https://api.kunavo.com/v1 — Quick Chat siempre disponible, Agent Chat bajo opencode cuando el proveedor aparece allí.

Configuración → Copilot → BYOK → Añadir un proveedor → Añadir un proveedor personalizado

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

La URL base conserva aquí el sufijo /v1, y la documentación lo aclara con ejemplos, no con una frase: solo dice que «Un proveedor personalizado compatible con OpenAI debe tener una URL base», pero ambas plantillas compatibles con OpenAI que incluye tienen como valor predeterminado una URL que termina en /v1: http://localhost:11434/v1 para Ollama y http://localhost:1234/v1 para LM Studio. Además, indica que «La detección de modelos usa la respuesta /v1/models del endpoint». Si la detección no devuelve nada, ese par es lo primero que debes revisar.

Un proveedor BYOK no llega a todas las partes del complemento, y la documentación lo dice sin rodeos: «Añadir una clave no cambia los modelos proporcionados por Claude Code o Codex». Su propia tabla asigna los modelos BYOK a Quick Chat sin condiciones y a Agent Chat solo con el backend opencode, «cuando el proveedor aparece allí»: es una condición, no una regla general. Además, «Un modelo que opencode no pueda enrutar se excluye de la lista de opencode, pero quizá siga funcionando en Quick Chat». Si utilizas el backend de Claude o Codex, la configuración está en el entorno de su propia CLI: consulta /docs/integrations/claude-code.

Activar CORS es una concesión, no una solución que convenga dejar habilitada. La documentación dice: «Si la prueba se realiza correctamente pero Quick Chat no puede enviar un mensaje, edita el proveedor y activa Enable CORS. Las respuestas aparecerán al completarse, en lugar de transmitirse token por token». También señala que el interruptor no cambia el enrutamiento de opencode, así que activarlo para reparar Quick Chat te hace perder allí la salida token por token, y en ninguna otra parte.

Copilot 4.x no requiere ningún proveedor de embeddings: la búsqueda semántica pasó a Miyo, un servicio independiente, y el diálogo BYOK no tiene ese campo. Es lo apropiado, porque Kunavo no ofrece modelos de embeddings y esta página no dará a entender lo contrario.

Kunavo no ha probado este complemento en tiempo de ejecución. Todos los campos y citas anteriores se han consultado en la documentación del propio Copilot en la fecha indicada más abajo; una página de configuración publicada no equivale a una prueba. Envía una tarea real mediante Quick Chat antes de trasladar un flujo de trabajo.

¿Aún no tienes una clave? Crea una cuenta de Kunavo, genera una clave (empieza por sk-kn-) y añade crédito desde $10; las llamadas se pagan con ese saldo y las llamadas fallidas no se facturan. El panel se abre entonces en la configuración de Copilot para Obsidian.

Paso a paso

Cree una clave en /app/keys y cópiela: se muestra una sola vez.
En Obsidian, abre Settings → Copilot → BYOK y haz clic en Add a provider.
Elige Add a custom provider, en lugar de un proveedor con nombre o una plantilla Self Host.
Rellena Display name, API key y Base URL como se indicó antes. Por ahora, deja desactivado Enable CORS.
Añade al menos un modelo: escribe un id en Model ID → Add o elígelo en Search available models, que se completa a partir de GET /v1/models. Haz clic en Test y luego en Save; no se podrá guardar hasta que haya un modelo y un endpoint enrutable.
Elige dónde aparecen esos modelos en Basic → Agents → Quick Chat y Basic → Agents → opencode, cada uno con su propio Default model. Los modelos de chat nuevos están habilitados para ambos de forma predeterminada.

Comprobado con Página de fuentes de modelos y BYOK de Copilot el 21 de septiembre de 2026. La configuración de terceros puede cambiar; si el nombre de un campo ya no coincide con lo que ves, esa página es la autoridad, no esta.

Esta es la versión breve. El tutorial completo —elección del modelo, coste de una sesión real y modos de fallo— está en qué backend de Copilot paga realmente los tokens.

Verifica antes de depurar el cliente

Una solicitud determina si el fallo está en el endpoint, la clave o el archivo de configuración. Si devuelve JSON, la misma URL base y la misma clave funcionan en Copilot para 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-..."

Qué ID de modelo introducir en el campo

Todos los modelos de texto están disponibles mediante un ID de modelo; la lista activa está en GET /v1/models, y el catálogo con precios está en la página de modelos. Las tarifas son USD por 1M de tokens, entrada / salida.

ID de modelo	Entrada / salida de Kunavo	Dónde encaja en Copilot para Obsidian
`claude-haiku-4-5`	$0.70 / $3.50	Quick Chat, para consultas breves sobre una nota a lo largo del día
`claude-sonnet-5`	$1.40 / $7.00	el backend opencode de Agent Chat: el modelo de trabajo predeterminado
`claude-opus-5`	$3.50 / $17.50	síntesis extensas de muchas notas, donde interpretar algo mal sale caro
`gpt-5-6-sol`	$2.00 / $12.00	una segunda opinión de otra familia, con la misma clave y la misma fila de proveedor

La facturación es por token desde un saldo prepago, sin cuota mensual; consulta facturación. Con contexto repetido —que constituye la mayor parte de lo que envía un editor o cliente de chat—, la caché de indicaciones cambia más la factura que la elección del modelo.

Preguntas frecuentes

¿Dónde introduzco una clave de API en Obsidian Copilot?

Settings → Copilot → BYOK → Add a provider y luego «Add a custom provider» para un endpoint que no figure en la lista integrada. El diálogo solicita un Display name, la clave de API, una Base URL, el interruptor opcional Enable CORS y al menos un modelo, que se añade mediante un id o se selecciona de la lista detectada; después, haz clic en Save. Según la documentación de Copilot, las claves de proveedor se guardan en el Llavero de Obsidian de ese dispositivo, no en el archivo data.json de la bóveda, así que sincronizar una bóveda no lleva las credenciales a otro ordenador.

¿La URL base de Obsidian Copilot debe terminar en /v1?

Usa el formato con /v1: https://api.kunavo.com/v1 para Kunavo. La documentación no expresa la regla en una frase; indica que un proveedor personalizado compatible con OpenAI debe tener una Base URL, que la detección de modelos usa la respuesta /v1/models del endpoint y que las dos plantillas compatibles con OpenAI incluidas usan por defecto http://localhost:11434/v1 y http://localhost:1234/v1. Ambos valores predeterminados incluidos llevan el sufijo, que es lo más concluyente que dice la documentación. Una URL base incorrecta suele manifestarse como una lista de modelos vacía o una prueba fallida, no como un error de autenticación.

¿Puede Obsidian Copilot usar una pasarela como OpenRouter o Kunavo en vez de una clave de proveedor?

Sí, en Quick Chat, y con condiciones, en Agent Chat. La documentación de Copilot describe BYOK como una forma de conectarse «directamente a un proveedor de IA, una pasarela compatible o un servidor de modelos en tu ordenador», y la opción «Add a custom provider» admite cualquier URL base compatible con OpenAI más un id de modelo. La tabla de fuentes de modelos asigna los modelos BYOK a Quick Chat sin condiciones y a Agent Chat solo con el backend opencode, «cuando el proveedor aparece allí». Los backends de Claude y Codex nunca aceptan una clave BYOK: la documentación indica que añadir una clave no cambia los modelos que proporcionan.

¿Necesito un modelo de embeddings para la búsqueda en la bóveda de Obsidian Copilot?

No necesitas uno de tu proveedor de chat. Copilot 4.x ya no mantiene su propio índice dentro del complemento: la documentación indica que la búsqueda semántica y Relevant Notes las proporciona Miyo, un servicio independiente que puede ser local o remoto, y el diálogo BYOK no incluye un campo para ese tipo de modelo. Kunavo tampoco ofrece modelos de embeddings, así que no debe interpretarse que aquí se ofrece uno: una fila de proveedor de chat en Copilot paga por el chat y nada más.

¿Una clave de Kunavo sustituye una licencia Copilot Lite o Plus?

No, son dos conceptos separados deliberadamente. La documentación de Copilot trata la licencia y BYOK como fuentes de modelos distintas: una licencia proporciona modelos alojados por Copilot, facturados por Brevilabs según tu plan; BYOK envía las solicitudes a tu propio endpoint y la facturación queda a cargo de ese proveedor. Una clave de aquí no repone el saldo de una licencia, no desbloquea las filas bloqueadas de Copilot ni cambia los servicios sujetos a licencia; a la inversa, puedes usar BYOK en el plan gratuito sin ninguna licencia.