Documentación

Documentación

Page Assist

Page Assist se creó para usar Ollama en local, pero esa misma pantalla permite configurar un endpoint alojado: Settings → OpenAI Compatible API → Add Provider → Custom. Son tres campos, y la barra lateral resume la pestaña que tienes abierta con Claude o GPT, en lugar de limitarse a lo que cabe en la RAM de tu portátil.

Settings → OpenAI Compatible API → Add Provider → Custom: Provider Name, una URL base que conserva /v1 y la clave — después marca los IDs de modelo de la lista que Page Assist obtiene por sí mismo.

Configuración → API compatible con OpenAI → Añadir proveedor → Personalizado
Provider Name   Kunavo
Base URL        https://api.kunavo.com/v1
API Key         sk-kn-...
                [ Save ]

Model List      (appears after Save — fetched from GET /v1/models)
  [x] claude-haiku-4-5
  [x] claude-sonnet-5
  [x] gpt-5-6-terra
La Base URL conserva el sufijo /v1. La página OpenAI Compatible API no lo especifica; lo indica el propio campo. Su texto de ayuda dice «La URL base del proveedor de la API de OpenAI. p. ej. (http://localhost:1234/v1)», y las dos páginas de proveedores relacionadas que muestran una URL concreta para el mismo campo coinciden: en la de LM Studio dice «de forma predeterminada es http://localhost:1234/v1» y la de LLaMA.cpp muestra http://localhost:8080/v1. Page Assist solo añade la ruta, así que el origen sin sufijo produce un 404, no un 401: lo contrario de lo que ocurre con los clientes de estilo Anthropic, que solo necesitan el origen.
La lista Model List se obtiene del endpoint; normalmente, no se escribe a mano. Después de Save, Page Assist abre un Model List con el texto «Selecciona los modelos de chat que quieres usar con este proveedor», y lo completa con los datos del endpoint. Kunavo responde GET /v1/models, así que la lista se carga automáticamente. Si aparece vacía, la extensión muestra «No se ha encontrado ningún modelo. Asegúrate de haber añadido un proveedor correcto con la URL base y la clave de API», y el mensaje es acertado: una lista vacía suele deberse a un problema con la URL base o la clave, no con el catálogo. Compruébalo con el curl de abajo antes de cambiar la configuración de la extensión. También puedes añadir identificadores manualmente mediante Add Custom Model, cuyo campo Model ID acepta sin cambios un identificador de la tabla de esta página.
Selecciona Chat Model, no la otra opción. El formulario Add Custom Model ofrece una opción Model Type, pero Kunavo no ofrece modelos de embeddings: ningún modelo del catálogo responde a ese endpoint, así que aquí no hay nada que asignar a la segunda opción. La función Knowledge Base depende de ello: la página del proveedor indica que debes configurar uno en RAG Settings y recomienda nomic-embed-text. Mantén una instancia local de Ollama configurada junto con este proveedor para esa tarea. Page Assist permite tener varios proveedores a la vez, y no es necesario que ambos roles usen el mismo.
La configuración de audio requiere una configuración aparte. La sección Text-to-Speech de Page Assist ofrece un proveedor OpenAI TTS con su propia API Key, Base URL y TTS Model; Kunavo no ofrece modelos de texto a voz. Lo mismo ocurre en sentido inverso: Kunavo no ofrece modelos de voz a texto y la entrada de voz de Page Assist utiliza el reconocedor propio del navegador, configurado en Speech Recognition Language, en lugar de hacer una llamada a una API. Deja ambas secciones configuradas como están.
Esta configuración se basa en la documentación del proveedor y en los textos de su propia interfaz, consultados en la fecha que se indica abajo. Kunavo no ha ejecutado Page Assist contra su endpoint: no ha fijado una versión de la extensión, iniciado una sesión en la barra lateral, recibido una respuesta en streaming ni realizado un intercambio de llamadas a herramientas. Una página de configuración publicada no es una prueba, y no debe interpretarse como tal. Lo que sí puedes comprobar por tu cuenta en diez segundos es el curl; el comportamiento de la extensión sobre un endpoint operativo depende de Page Assist.
¿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 Page Assist.

Paso a paso

  1. Cree una clave en /app/keys y cópiela: se muestra una sola vez.
  2. Haz clic en el icono de Page Assist de la barra de herramientas del navegador, luego en el icono Settings y ve a la pestaña OpenAI Compatible API.
  3. Haz clic en Add Provider. Kunavo no figura entre los ajustes preestablecidos del menú desplegable, así que elige Custom: esa es la opción que, en el paso 5, la guía del proveedor indica para cualquier servicio que no aparezca en la lista.
  4. Completa Provider Name, Base URL = https://api.kunavo.com/v1 y API Key; luego haz clic en Save.
  5. En la lista Model List que se abre, marca los identificadores que quieras. Normalmente, dos es la cantidad adecuada: uno barato para resumir páginas y otro potente para las preguntas posteriores.
  6. Abre la barra lateral en una página real —Ctrl+Shift+L abre la interfaz web—, selecciona el modelo en el selector y pregúntale sobre la pestaña. Una página con contenido real te permite evaluar mejor el resultado que un saludo, porque el texto de la página es lo que cuesta dinero.

Comprobado con La página OpenAI Compatible API de Page Assist 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.

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 Page Assist.

# 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 modeloEntrada / salida de KunavoDónde encaja en Page Assist
claude-haiku-4-5$0.70 / $3.50la opción predeterminada para una barra lateral: resúmenes de páginas y preguntas de seguimiento, donde el volumen es lo que más influye
gpt-5-6-terra$0.70 / $4.20páginas largas —documentación, hilos, transcripciones— enviadas enteras en lugar de recortarlas
claude-sonnet-5$1.40 / $7.00la pregunta posterior al resumen, cuando la respuesta debe ser correcta
gpt-5-6-sol$2.00 / $12.00una segunda opinión de otra familia; añádela como un segundo id marcado, con el mismo 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.

Cuánto cuesta la página y qué datos salen del navegador

Un cliente de barra lateral factura de forma distinta a un editor, y la diferencia está en la página. Cada turno en que Page Assist conversa sobre la pestaña incluye como tokens de entrada el texto extraído de esa pestaña: una página de documentación o un hilo largo puede contener decenas de miles, y se vuelve a enviar con cada pregunta de seguimiento de la misma conversación. Por eso, la tabla de modelos de arriba empieza por los identificadores baratos: en este cliente, los tokens de entrada suelen superar en un orden de magnitud a los de salida, y claude-haiku-4-5 o gpt-5-6-terra al leer una página entera supera a un modelo más potente que lea una versión truncada.

Hay tres opciones que añaden tráfico que no pediste explícitamente; las tres aparecen en la página Settings del proveedor:

  • Generate Title using AI: «Genera automáticamente un título de chat a partir de la conversación». Añade una llamada por conversación al modelo seleccionado.
  • Internet Search, con Internet Search ON by default y Total Search Results: las páginas obtenidas se añaden a la solicitud, así que el coste en tokens aumenta con el número de resultados.
  • Page Action, la extensión complementaria: el modelo «empieza leyendo la página y después realiza las acciones de una en una», lo que implica leer el DOM en cada paso, no en cada conversación. La opción Require approval before each action está activada de forma predeterminada y conviene dejarla así.

El límite de privacidad sigue la misma lógica. Page Assist guarda los chats, la base de conocimientos y la configuración localmente en el almacenamiento del navegador; lo que cruza la red es lo que envías. Cuando seleccionas este proveedor, eso significa que el texto de la página, tu mensaje y el historial de la conversación se envían a api.kunavo.com, y desde allí al proveedor ascendente que sirve el identificador del modelo. Consulta la política de privacidad para saber qué se conserva en este servicio. Si no pegarías una página en una ventana de chat, vuelve a usar Ollama en local para esa página; la extensión permite tener ambos proveedores configurados a la vez precisamente para cambiar entre ellos con un solo menú desplegable.

Si llegaste aquí desde el ajuste preestablecido de OpenRouter

OpenRouter no requiere la opción Custom. Es uno de los ajustes preestablecidos de la página OpenAI Compatible API del proveedor, junto con Ollama, LM Studio, Groq, Together, Mistral, xAI y unos veinte servicios más. Por tanto, el proceso sigue los mismos cuatro primeros pasos; luego selecciona OpenRouter en el menú desplegable en lugar de Custom, introduce su clave en API Key y haz clic en Save. El ajuste preestablecido incluye su propia URL base, y los identificadores de modelo de OpenRouter llevan el prefijo del proveedor —tienen el formato anthropic/claude-sonnet-4.5—, mientras que los identificadores de la tabla de arriba no llevan prefijo. Al elegir un proveedor, eliges el espacio de identificadores que vas a introducir.

En este cliente, te conviene cambiar a OpenRouter si quieres una sola interfaz que también dé acceso a modelos que Kunavo no ofrece, o si ya tienes la clave configurada y el coste adicional de configuración es nulo. Te conviene cambiar a Kunavo si también usas los identificadores de la tabla en tus herramientas de programación: una sola clave cubre ambos casos, y el almacenamiento en caché de solicitudes para el contexto de página que se vuelve a enviar es lo que realmente determina el coste de una barra lateral; consulta el almacenamiento en caché. Puedes conservar ambos proveedores: Page Assist los muestra juntos y al selector de modelos no le importa de cuál procede cada modelo.

Preguntas frecuentes

¿Cómo uso una API personalizada con Page Assist?

Haz clic en el icono de Page Assist de la barra de herramientas del navegador, abre Settings, ve a la pestaña OpenAI Compatible API y haz clic en Add Provider. Si tu endpoint no aparece entre los ajustes preestablecidos del menú desplegable, selecciona Custom y completa Provider Name, Base URL y API Key; después, haz clic en Save. A continuación, Page Assist abre una lista Model List obtenida del endpoint, donde puedes marcar los modelos de chat que quieras usar con ese proveedor. Si no se obtiene ningún resultado, también puedes introducir identificadores manualmente mediante Add Custom Model.

¿La URL base de Page Assist debe incluir /v1?

Sí, si se trata de un endpoint compatible con OpenAI. La página OpenAI Compatible API no lo especifica, pero sí lo hace el texto de ayuda del campo Base URL: «La URL base del proveedor de la API de OpenAI. p. ej. (http://localhost:1234/v1)». Las páginas de LM Studio y LLaMA.cpp muestran el mismo sufijo en ese campo: http://localhost:1234/v1 y http://localhost:8080/v1. Para Kunavo, la URL es https://api.kunavo.com/v1. Page Assist solo añade la ruta, así que si omites el sufijo obtendrás un 404, no un error de autenticación.

¿Por qué Page Assist no muestra modelos después de añadir un proveedor?

La lista se obtiene del endpoint con la clave que acabas de introducir, y el propio mensaje de la extensión indica qué debes comprobar: «No se ha encontrado ningún modelo. Asegúrate de haber añadido un proveedor correcto con la URL base y la clave de API». Prueba esa misma combinación fuera de la extensión con una llamada curl a /v1/models: si recibes JSON, el problema está en la configuración del proveedor; si obtienes un 401, la clave es incorrecta; y un 404 suele indicar que falta /v1 en la URL base. Si no se resuelve, añade identificadores manualmente mediante Add Custom Model, que no depende de la consulta al endpoint.

¿Puede Page Assist usar Claude o GPT en lugar de un modelo local?

Sí. «OpenAI Compatible API» identifica el formato de comunicación, no el proveedor, y el identificador del modelo se pasa al valor que hayas configurado como URL base; así, ese endpoint resuelve un identificador de Claude o GPT, no la extensión. Las funciones de modelos locales siguen disponibles: Page Assist permite tener varios proveedores a la vez, de modo que una entrada de Ollama y otra alojada pueden estar juntas y puedes alternar entre ellas en el selector de modelos.

¿Qué modelo es el más barato para Page Assist?

En este cliente predominan los tokens de entrada, porque al conversar sobre una pestaña se vuelve a enviar el texto extraído de esa pestaña en cada turno. Por eso, un modelo barato con una ventana de contexto amplia es la mejor opción predeterminada: claude-haiku-4-5 para páginas corrientes y gpt-5-6-terra para las largas. Marca también un identificador más potente, como claude-sonnet-5, como segunda opción para las preguntas en las que importa la respuesta. La tabla de esta página incluye las tarifas por millón de tokens de cada modelo, y el almacenamiento en caché de solicitudes influye más en el coste de una barra lateral que la elección del modelo.

¿Puede la base de conocimientos de Page Assist usar Kunavo?

No para la parte de indexación. La base de conocimientos es una función RAG y la documentación del proveedor indica que debes configurar un modelo de embeddings en RAG Settings; recomienda nomic-embed-text. Kunavo no ofrece modelos de embeddings, así que ese campo requiere otro proveedor. La opción habitual es Ollama en local, que funciona junto con este proveedor sin conflictos. La parte de chat no se ve afectada: una vez indexados los documentos, cualquier identificador de chat de este proveedor puede responder preguntas sobre ellos.

¿Kunavo ha probado Page Assist?

No. Lo que se comprobó el 21 de septiembre de 2026 fue la documentación de la propia API OpenAI Compatible de Page Assist y los textos en inglés de la interfaz de la extensión. De ahí se citan la ruta por Settings, las etiquetas y el orden de los campos, el ejemplo de URL base y el mensaje que aparece cuando la lista está vacía. Kunavo no ha instalado la extensión, fijado una versión ni enviado una solicitud a través de ella, y no afirma nada sobre el streaming, la extracción de páginas ni el funcionamiento de la consulta Model List en una versión concreta. La llamada curl de esta página es lo que puedes verificar de forma independiente.