Documentación

ChatWise

ChatWise mantiene todos los proveedores detrás de los mismos tres campos. Asigna un nombre al proveedor personalizado, introduce una API Base URL y una clave, pulsa Fetch y el selector de modelos se llenará con identificadores Claude y GPT que usan un mismo saldo.

Settings → Providers → "+" crea un proveedor personalizado con tres campos — Provider name, API Base URL configurada como https://api.kunavo.com/v1 y API Key — y después Fetch obtiene la lista de modelos del endpoint.

Configuración → Proveedores → «+» → configuración personalizada

Provider name    Kunavo
API Base URL     https://api.kunavo.com/v1
                 field help: "Do NOT include /chat/completions in the URL"
API Key          sk-kn-...
Models           click Fetch to read the list from the endpoint,
                 or "+ New" and type an id by hand

"+ New" → Chat Models, the fields the docs name:
  Model ID       claude-sonnet-5
  Display Name   Claude Sonnet 5 (Kunavo)
  Capabilities   image input / reasoning flag — tick what the model does
  Context length as published on the models page

API Base URL conserva su /v1. ChatWise muestra la regla debajo del campo: «No incluyas /chat/completions en la URL», así que el valor es la raíz de la ruta, no la ruta misma. La única pasarela alojada que sus documentos muestran con ese campo rellenado tiene la misma forma, https://aihubmix.com/v1. Si la URL base ya incluye la ruta, se produce un error 404, no un error de autenticación.

Esta configuración es una interpretación de la documentación de ChatWise vigente en la fecha indicada abajo. Kunavo no ha probado ChatWise con su endpoint: ni una sesión, ni un turno en streaming ni un ciclo completo de llamada a una herramienta; lo mismo ocurre con todos los clientes de esta familia. Una página de configuración publicada no equivale a una prueba de compatibilidad. Mantén disponible la ruta que ya te funciona mientras pruebas esta.

Kunavo no ofrece modelos de embeddings, texto a voz ni voz a texto, por lo que esta ruta solo responde a solicitudes de chat y generación de imágenes. La función de entrada de audio de ChatWise es distinta y no se ve afectada: adjunta un archivo de audio a un mensaje para un modelo que lo acepte, en lugar de llamar a un servicio de transcripción.

Rellenar este campo desactiva una extensión de ChatWise. Su página de observabilidad advierte: «Asegúrate de que API Base URL del proveedor correspondiente esté vacía; de lo contrario, la observabilidad no se habilitará». El panel de Cloudflare AI Gateway y el cambio de URL base son opciones mutuamente excluyentes por proveedor; por eso conviene añadir Kunavo como una entrada de proveedor propia en lugar de editar una integrada.

Varios productos distintos usan el nombre ChatWise. Esta página trata del cliente de escritorio disponible en chatwise.app, para macOS, Windows y Linux, cuya documentación está en docs.chatwise.app. Su repositorio público de versiones en GitHub llega hasta mucho antes de la versión disponible, así que, si una captura de pantalla de esta página no coincide con lo que ves, consulta la descarga de la aplicación en vez de ese repositorio.

¿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 ChatWise.

Paso a paso

Cree una clave en /app/keys y cópiela: se muestra una sola vez.
En ChatWise, abre Settings → Providers y haz clic en «+» para añadir un proveedor. La documentación ofrece dos opciones: elegir uno de los ajustes preestablecidos integrados o crear una configuración personalizada. Kunavo no es un ajuste preestablecido, así que elige la segunda.
Rellena Provider name, API Base URL y API Key como se indicó arriba. El formulario no permite elegir un proveedor: el endpoint resuelve el identificador de modelo, por lo que usar un identificador Claude con un proveedor compatible con OpenAI es la combinación prevista, no una incompatibilidad.
En la fila Models, pulsa Fetch. Según la documentación de ChatWise, si la API admite el endpoint /models, puede añadir automáticamente los modelos disponibles. Kunavo responde a GET /v1/models, así que la lista se completa sola. La opción + New permite escribir los identificadores manualmente.
Si añades un modelo manualmente, la documentación indica los campos: Model ID es el identificador de la API y Display Name es solo una etiqueta, así que el identificador debe coincidir exactamente con el del catálogo. Marca Capabilities y establece Context length según el modelo. Esas opciones indican al cliente qué funciones ofrecer, no le dicen al endpoint qué hacer.
Elige el proveedor en el selector de modelos y envía un mensaje. Para los modelos de imagen, la página de generación de imágenes de ChatWise añade un paso: establece el tipo de modelo en Image para que aparezca en el selector de imágenes.

Comprobado con Página de proveedores personalizados de ChatWise 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 el costo real de usar ChatWise.

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

# 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 ChatWise
`claude-sonnet-5`	$1.40 / $7.00	el hilo de uso diario: conversaciones largas en las que la calidad por dólar es decisiva
`claude-opus-5`	$3.50 / $17.50	la pregunta difícil para la que, de otro modo, abrirías una segunda aplicación
`claude-haiku-4-5`	$0.70 / $3.50	títulos, resúmenes y llamadas en segundo plano que un cliente de chat realiza por su cuenta
`gpt-5-6-terra`	$0.70 / $4.20	documentos largos pegados, donde el límite es la ventana de contexto
`gpt-5-6-sol`	$2.00 / $12.00	una segunda opinión de otra familia con la misma clave

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

¿Cómo añado un proveedor de API personalizado a ChatWise?

Abre Settings, ve a Providers y haz clic en «+» para añadir un proveedor. Luego, elige un ajuste preestablecido o crea una configuración personalizada. Rellena Provider name, API Base URL y API Key, y añade modelos con el botón Fetch o con «+ New». La documentación de ChatWise sobre proveedores personalizados describe esta función como una forma de integrar cualquier servicio de IA compatible con OpenAI o Anthropic, por lo que las pasarelas son una opción admitida directamente, no una solución provisional.

¿API Base URL de ChatWise debe terminar en /v1?

Sí, para un endpoint compatible con OpenAI. ChatWise indica la regla debajo del campo: no incluyas /chat/completions en la URL. El cliente añade la ruta, así que el valor debe ser la raíz /v1: https://api.kunavo.com/v1. La única pasarela alojada que ChatWise documenta con el campo rellenado tiene el mismo formato: https://aihubmix.com/v1. Si omites /v1, se produce un error 404 en lugar de un fallo de autenticación, lo que constituye la forma más rápida de distinguir ambos errores.

¿Por qué Fetch no devuelve modelos en ChatWise?

La lista se obtiene de la ruta /models del endpoint usando la clave que introdujiste, así que un resultado vacío suele indicar un problema con la clave o la URL base, no que el catálogo esté vacío. Prueba el mismo par fuera de la aplicación con un curl sencillo a /v1/models: si recibes JSON, el problema está en el formulario del proveedor; un 401 indica un problema con la clave y un 404, con la URL. También puedes añadir los modelos manualmente con «+ New»; en ese caso, Model ID debe coincidir exactamente con el identificador del catálogo.

¿Hace falta una suscripción o licencia de ChatWise para usar mi propia clave de API?

Son dos relaciones de pago independientes. ChatWise es un cliente que se compra una sola vez, y el acceso a los modelos se factura a través de quien tenga tu clave. Con una clave de Kunavo, se descuenta un saldo prepago por token, sin cuota mensual adicional. La configuración de proveedores no aparece entre las funciones que se desbloquean con el plan de pago, pero ninguna página de ChatWise afirma expresamente que el plan gratuito permita añadir un proveedor personalizado; confirma ese punto durante el periodo de prueba antes de depender de ello.

¿ChatWise puede usar modelos Claude sin una cuenta de Anthropic?

Sí, mediante una entrada de proveedor compatible con OpenAI. El endpoint configurado resuelve el identificador de modelo, no ChatWise, así que las credenciales que tienes son las de ese endpoint. Esta ruta es distinta de iniciar sesión en una suscripción existente desde la aplicación, una opción que ChatWise también anuncia: esa depende de las condiciones de otro proveedor, mientras que una clave facturada a tu nombre no. Kunavo no ha probado ChatWise con su endpoint, así que considera esta página una interpretación de la configuración, no un resultado de una prueba.