Documentación

Chatbox

Chatbox divide el endpoint entre un host y una ruta, y completa la ruta por ti. Por eso, el host debe ser el origen: incluir /v1 en él es el error que este cliente propicia.

Añade un proveedor de tipo OpenAI API Compatible con API Host configurado en la raíz del servicio — Chatbox añade /v1/chat/completions automáticamente.

Configuración de Chatbox

Settings → Model Providers → Add

  API 提供方名称 / Provider name   Kunavo
  API 类型 / Type                 OpenAI API 兼容 (OpenAI API compatible)
  API 密钥 / API Key              sk-kn-...
  API 主机 / API Host             https://api.kunavo.com
  API 路径 / API Path             (leave empty → /v1/chat/completions)
  Model                           claude-sonnet-5

API Host es https://api.kunavo.com, sin /v1. Chatbox tiene un campo API Path independiente, cuyo valor predeterminado es /v1/chat/completions, así que un host que ya termina en /v1 genera solicitudes a /v1/v1/chat/completions. Deja la ruta vacía salvo que sepas que necesitas otra cosa.

El selector de tipo de proveedor de Chatbox indica un formato de comunicación. Elige Compatible con API de OpenAI (OpenAI API compatible) y luego escribe un identificador de modelo Claude: el endpoint resuelve el identificador, así que ambas opciones son compatibles.

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

Paso a paso

Cree una clave en /app/keys y cópiela: se muestra una sola vez.
Abre Settings → Model Providers y haz clic en Add.
Asigna un nombre al proveedor, establece el tipo como Compatible con API de OpenAI y pega la clave de API.
Establece API 主机 / API Host en https://api.kunavo.com y deja vacío API 路径 / API Path.
Añade los identificadores de modelo que quieras, guarda e inicia una conversación.

Comprobado con Guía de configuración de proveedores de Chatbox el 6 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 Chatbox.

# 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 Chatbox
`claude-sonnet-5`	$1.40 / $7.00	el modelo predeterminado de conversación
`claude-haiku-4-5`	$0.70 / $3.50	intercambios breves en los que importan tanto la latencia como el precio
`claude-opus-5`	$3.50 / $17.50	una segunda entrada de proveedor para preguntas difíciles
`gpt-5-6-terra`	$0.70 / $4.20	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

¿Qué valor debo usar en API Host de Chatbox para un endpoint compatible con OpenAI?

El origen, sin una ruta; por ejemplo, https://api.example.com. Chatbox tiene un campo API Path independiente cuyo valor predeterminado es /v1/chat/completions, y su documentación indica que, en general, no hace falta rellenarlo. Por tanto, /v1 procede de la ruta, no del host. Si el host termina en /v1, las solicitudes se envían a /v1/v1/chat/completions y devuelven un error 404.

¿Cómo añado un proveedor de modelos personalizado en Chatbox?

Abre Settings → Model Providers y haz clic en Add. Luego, asigna un nombre al proveedor, elige el tipo de API compatible con OpenAI, pega la clave de API, establece API Host en el origen del endpoint y deja API Path vacío. Añade los identificadores de modelo que quieras usar y guarda; el proveedor aparecerá en el selector de modelos de todas las conversaciones.

¿Chatbox puede conectarse a modelos Claude?

Sí, mediante un endpoint compatible con OpenAI que los ofrezca. Chatbox envía el identificador de modelo que escribiste al host configurado, por lo que un identificador de Claude se resuelve allí en lugar de en Chatbox, y la aplicación nunca necesita credenciales propias de Anthropic. El selector de tipo de proveedor define el formato de comunicación, no el proveedor.

¿Cuándo debo rellenar API Path de Chatbox?

Solo cuando el endpoint no ofrece Chat Completions en /v1/chat/completions. El campo existe para pasarelas con un enrutamiento poco habitual; en un servicio estándar compatible con OpenAI, dejarlo vacío es lo correcto. Escribir una ruta suele causar errores 404 que parecen problemas de autenticación.