Documentación

SillyTavern

La fuente Custom (OpenAI-compatible) de SillyTavern requiere una URL base y una clave. Al conectarla a Kunavo, Claude y GPT aparecen en el mismo menú desplegable de modelos.

Para conectar SillyTavern a Kunavo, abra API Connections, establezca API en Chat Completion y Chat Completion Source en Custom (OpenAI-compatible); luego complete dos campos: Custom Endpoint = https://api.kunavo.com/v1 y Custom API Key = su clave sk-kn-…. Pulse Connect; SillyTavern llamará a GET /v1/models y completará el menú desplegable de modelos con la respuesta.

Campo de SillyTavern	Valor
API	Chat Completion
Chat Completion Source	Custom (OpenAI-compatible)
Custom Endpoint (Base URL)	`https://api.kunavo.com/v1`
Custom API Key	`sk-kn-…`
Modelos disponibles	Se completa automáticamente después de Connect: seleccione cualquier id

El sufijo /v1 debe incluirse en este campo. La fuente personalizada de SillyTavern sigue la convención de OpenAI y solo añade la ruta; sin https://api.kunavo.com, /v1 provoca un fallo de conexión y una lista de modelos vacía.

Paso a paso

Cree una clave en /app/keys y cópiela: se muestra una sola vez.
En SillyTavern, abra el icono del enchufe (API Connections) en la barra superior.
Establezca API → Chat Completion y, después, Chat Completion Source → Custom (OpenAI-compatible).
Pegue https://api.kunavo.com/v1 en Custom Endpoint y la clave en Custom API Key.
Pulse Connect. Si aparece el estado verde y se completa el menú desplegable de Modelos disponibles, la conexión funcionó.
Seleccione un id de modelo del menú desplegable e inicie un chat. Para cambiar de modelo más adelante no es necesario volver a conectarse.

La referencia de SillyTavern para esta pantalla es la página de conexiones de API de Chat Completions.

Compruébelo antes de depurar la interfaz

Una solicitud basta para determinar si el fallo se debe al endpoint, a la clave o a SillyTavern. Si devuelve una lista JSON de id de modelos, la misma URL y clave completarán el menú desplegable.

# Confirms the key and the endpoint before you touch SillyTavern.
# A JSON list of model ids means the same URL will populate the dropdown.
curl -sS https://api.kunavo.com/v1/models \
  -H "Authorization: Bearer sk-kn-..."

Qué modelos elegir

Todos los modelos de texto de Kunavo están disponibles en el mismo menú desplegable: la lista completa está en la página de modelos y se obtiene en tiempo real desde GET /v1/models. Las tarifas son USD por 1M de tokens, entrada / salida.

ID de modelo	Entrada / salida de Kunavo	Uso recomendado
`claude-haiku-4-5`	$0.70 / $3.50	El Claude más económico: para sesiones largas en las que más importa el coste por turno
`claude-sonnet-5`	$1.40 / $7.00	El equilibrio predeterminado entre calidad y precio
`claude-opus-5`	$3.50 / $17.50	El nivel de Claude de mayor calidad
`claude-fable-5`	$7.00 / $35.00	Razonamiento de vanguardia con una ventana de contexto de 1M tokens: la opción ideal cuando el propio historial del chat es el problema

En una sesión larga de SillyTavern, la longitud del contexto es el primer límite que se hace notar: se vuelve a enviar todo el historial en cada turno, por lo que el gasto en tokens crece con la conversación en vez de mantenerse estable. Kunavo factura por token a partir de un saldo prepago, sin cuota mensual, así que un mes de inactividad no cuesta nada. Encontrará los detalles en facturación; para el contexto repetido, el almacenamiento en caché de solicitudes es lo que más influye.

Solución de problemas

Síntoma	Causa	Solución
Falla la conexión y la lista de modelos sigue vacía	Falta `/v1` en Custom Endpoint	Use `https://api.kunavo.com/v1`. Confírmelo con el comando curl anterior.
401 / clave no válida	La clave se pegó con espacios en blanco o se revocó	Vuelva a copiarla desde `/app/keys`; consulte Errores 401 y 403
Las respuestas llegan todas a la vez, sin transmisión en flujo	Un proxy delante de la conexión está almacenando en búfer los eventos enviados por el servidor	La transmisión en flujo del lado del endpoint es compatible: consulte errores de transmisión en flujo
Se rechaza el id del modelo	El endpoint no ofrece ese id	Elija uno del menú desplegable o consulte model_not_found
Solo hay errores en chats largos	El historial supera la ventana de contexto del modelo	Recorte el historial o cambie a un modelo con más contexto; consulte context_length_exceeded

Dos aclaraciones importantes

Sin afiliación

SillyTavern es un proyecto independiente de código abierto y no está afiliado a Kunavo. Esta página documenta una configuración funcional porque SillyTavern admite endpoints arbitrarios compatibles con OpenAI; no hay nada adaptado específicamente en ninguno de los dos lados.

La política de contenido sigue vigente

Las solicitudes a través de Kunavo llegan a proveedores upstream, y cada proveedor aplica su propia política de uso al contenido que recibe. Una pasarela no elimina esos límites, y cualquier página que afirme lo contrario intenta venderle algo. Las condiciones de Kunavo figuran en la política de uso aceptable.

Preguntas frecuentes

¿Cómo conecto SillyTavern a un endpoint de API personalizado?

En SillyTavern, abra la pestaña API Connections (el icono del enchufe), establezca API en Chat Completion y Chat Completion Source en Custom (OpenAI-compatible). Introduzca la URL base compatible con OpenAI de la pasarela en Custom Endpoint; para Kunavo es https://api.kunavo.com/v1. Introduzca la clave en Custom API Key y pulse Connect. SillyTavern realizará entonces una llamada GET /v1/models a ese endpoint y completará el menú desplegable de modelos con la respuesta.

¿Funciona SillyTavern con modelos Claude a través de un endpoint compatible con OpenAI?

Sí. La fuente Custom (OpenAI-compatible) de SillyTavern solo requiere un endpoint que implemente POST /v1/chat/completions, por lo que los modelos Claude ofrecidos en ese formato funcionan sin recurrir a la fuente independiente de Anthropic de SillyTavern. En Kunavo, los id de los modelos Claude y GPT aparecen en el mismo menú desplegable con una sola clave, y cambiar de modelo no requiere volver a conectarse.

¿Funciona la transmisión en flujo en SillyTavern con un endpoint personalizado?

La transmisión en flujo funciona siempre que el endpoint implemente eventos enviados por el servidor en /v1/chat/completions, como hace Kunavo. Si las respuestas llegan en un único bloque completo, la causa habitual es que un proxy delante de la conexión almacena el flujo en búfer, no el endpoint en sí.

¿Por qué está vacía la lista de modelos de SillyTavern después de conectarse?

Un menú desplegable de modelos vacío en SillyTavern significa que falló la llamada GET /v1/models; el problema está en el endpoint o en la clave, no en SillyTavern. Las dos causas más habituales son que falte el sufijo /v1 en la URL base y que la clave no sea válida para ese endpoint. Ejecutar curl contra /v1/models con la misma clave reproduce el fallo fuera de SillyTavern y permite determinar cuál de las dos causas es.