Configurar la API de SillyTavern: URL base, clave y lista de modelos

Updated 2026-07-15

En SillyTavern, elige Chat Completion, pon la fuente en Custom (OpenAI-compatible), pega una URL base que termine en /v1 y añade tu clave de API. La lista desplegable de modelos se rellena sola desde el endpoint /v1/models del proveedor.

Respuesta rápida: los cinco ajustes que importan

Abre el panel de API Connections (el icono del enchufe) y configura exactamente esto: API = Chat Completion. Chat Completion Source = Custom (OpenAI-compatible). Custom Endpoint (Base URL) = https://api.apisrouter.com/v1. Custom API Key = tu clave sk-... . Haz clic en Connect, espera la luz verde y elige un modelo en la lista desplegable, por ejemplo deepseek-v4-flash. El fallo más común, con diferencia, es pegar la ruta completa. SillyTavern añade /chat/completions a lo que sea que escribas, así que la URL debe detenerse en /v1. Si pegas https://api.apisrouter.com/v1/chat/completions, SillyTavern solicita /v1/chat/completions/chat/completions y la conexión falla con un 404. Esto es justo lo contrario de JanitorAI, que quiere la URL completa de completions en su configuración de proxy. Mismo proveedor, convenciones de campo distintas.

Por qué la URL de la API de SillyTavern termina en /v1

Toda API compatible con OpenAI es una URL base más un conjunto de rutas fijas. GET /v1/models devuelve la lista de IDs de modelo que tu clave puede usar. POST /v1/chat/completions ejecuta la petición de chat en sí. SillyTavern conoce estas rutas y las construye por su cuenta, así que solo te pide la base. Cuando haces clic en Connect, llama a /v1/models con tu clave y usa la respuesta para rellenar la lista desplegable de modelos. Una lista vacía casi siempre significa que esa llamada falló. También debes elegir el modo de API correcto. Chat Completion envía mensajes estructurados con roles system, user y assistant, que es lo que espera cualquier proveedor alojado compatible con OpenAI. Text Completion envía una única cadena de prompt en bruto y existe principalmente para backends locales como KoboldCpp y text-generation-webui. Para cualquier clave de API alojada, usa Chat Completion. Si seleccionas Text Completion contra un endpoint de chat alojado, obtendrás errores o un formato ilegible, y varios samplers que se muestran en ese modo ni siquiera se aplican.

Configuración paso a paso

Si la lista sigue vacía después de Connect, revisa tres cosas en orden: que la URL termine en /v1 sin ruta adicional ni espacios al final, que la clave esté pegada sin comillas ni espacios en blanco, y que la fuente sea Custom (OpenAI-compatible) y no OpenAI a secas. La fuente OpenAI a secas ignora tu URL personalizada en algunas versiones y habla con api.openai.com, donde tu clave no es válida.

  • Consigue una clave. En APIsRouter no hay formulario de cuenta: pagas en /topup y la clave te llega por correo. Cualquier clave compatible con OpenAI funciona igual en estos pasos.
  • En SillyTavern, haz clic en el icono del enchufe para abrir API Connections.
  • Pon API en Chat Completion.
  • Pon Chat Completion Source en Custom (OpenAI-compatible).
  • En Custom Endpoint (Base URL), escribe https://api.apisrouter.com/v1 sin nada después de /v1.
  • Pega tu clave en el campo Custom API Key.
  • Haz clic en Connect. El punto de estado se pone verde y la lista Available Models se rellena desde /v1/models.
  • Selecciona un modelo, abre una tarjeta de personaje y envía un mensaje de prueba corto.

Verifica la conexión fuera de SillyTavern

Cuando algo falla, prueba el endpoint directamente antes de culpar a SillyTavern. Esta llamada curl es exactamente lo que hace el botón Connect. Si devuelve un array JSON de IDs de modelo, tu clave y tu URL están bien y el problema está en los campos de SillyTavern. Si la lista de modelos funciona pero los chats fallan, ejecuta una completion real desde Python con la misma URL base. Una respuesta correcta aquí demuestra que toda la cadena funciona, y cualquier mensaje de error que recibas es el error real del proveedor, no el genérico de SillyTavern.

curl https://api.apisrouter.com/v1/models \
  -H "Authorization: Bearer sk-your-key"

Lo básico de samplers y presets

Las fuentes Chat Completion exponen un conjunto pequeño de samplers: temperature, top P, frequency penalty y presence penalty, además del tamaño de respuesta y el contexto. Los samplers más sofisticados de los que quizá hayas oído hablar (min P, mirostat, dynamic temperature) pertenecen a los backends de Text Completion y sencillamente no se envían a las APIs de chat alojadas, así que no los busques aquí. Los presets en SillyTavern combinan dos cosas: los valores del sampler y la estructura del prompt que el Prompt Manager ensambla a partir de tu tarjeta de personaje, tu persona y tu lorebook. El preset Default incorporado es un punto de partida razonable. Cambia un valor cada vez y regenera la misma escena para ver qué hace en realidad. El tamaño de contexto merece atención: SillyTavern llena la ventana de contexto con el historial del chat, así que un contexto mayor significa más tokens de prompt enviados en cada turno, lo que mejora la memoria y sube el coste por mensaje al mismo tiempo.

Valores de partida para presets de Chat Completion. Ajusta uno a la vez.
AjustePunto de partidaQué hace en el roleplay
Temperature0.8Más alto (hasta 1.1) da variedad de prosa; más bajo (0.6) si el personaje se sale de la tarjeta
Top P0.95Déjalo así salvo que las respuestas se vuelvan incoherentes, entonces bájalo un poco
Frequency penalty0.1Combate los ritmos de frase repetidos en chats largos
Presence penalty0.05Valores pequeños desalientan que el tema se quede dando vueltas
Max response tokens350300 a 500 encaja bien con respuestas tipo párrafo sin divagar
Context sizeLímite del modelo o 16kMás historial por turno; también más tokens de entrada facturados por mensaje

Modelos recomendados para SillyTavern

La elección de modelo importa más que ajustar el sampler. El consenso de la comunidad, hasta donde llegan los informes aproximados, pone a la familia DeepSeek V4 primero por el precio: deepseek-v4-flash es la recomendación por defecto para chats largos y deepseek-v4-pro mantiene mejor unidas tarjetas complejas y chats grupales. GLM-5, Kimi K2.6 y MiMo son buenas opciones de valor con voces de prosa distintas, y vale la pena rotarlas cuando un chat empieza a sentirse repetitivo. Grok destaca porque la política publicada de xAI permite explícitamente temáticas maduras en contextos de ficción, algo relevante para tramas más oscuras. Claude escribe la mejor prosa de toda esta lista, pero la política de Anthropic prohíbe el contenido explícito, así que trata a Claude como la opción para escritura creativa SFW y escenas de estilo literario. Dos notas prácticas. Primero, SillyTavern es software dirigido a adultos, y cada modelo aquí aplica la política de contenido de su propio proveedor sin importar tu frontend, así que mantén tarjetas y escenas dentro de esas reglas. Segundo, como la lista se rellena en vivo desde /v1/models, puedes cambiar de modelo a mitad de chat y comparar respuestas al mismo mensaje, la forma más rápida de encontrar tu favorito.

ID de modeloFortaleza en SillyTavernNotas de política de contenido
deepseek-v4-flashFavorito de la comunidad para chats largos; mejor valor por mensajePolítica flexible para ficción; sigue bien las tarjetas de personaje
deepseek-v4-proMejor seguimiento de instrucciones para tarjetas complejas y chats grupalesMisma familia que Flash con mejor coherencia
glm-5Voz de prosa distinta; buen ritmo en escenas lentasOpción de valor para chats con mucho peso narrativo
kimi-k2.6Recuerda bien contextos largos para lorebooks grandesOpción de valor; maneja tarjetas grandes sin olvidar
grok-4.5Fuerte improvisación y réplicasLa política de xAI permite temáticas maduras en contextos de ficción
claude-sonnet-4-6La mejor calidad de prosa por su precioSolo escritura creativa SFW; Anthropic prohíbe el contenido explícito
claude-opus-4-7La mejor escritura literaria de formato largoMisma política solo SFW que Sonnet
gemini-3.5-flashRespuestas rápidas, contexto largoPolítica estándar de Google; buena para RP tipo aventura

Cuánto cuestan realmente los chats de SillyTavern

Los modelos alojados facturan por token, y el roleplay consume mucha entrada: cada turno reenvía la tarjeta de personaje más el historial reciente. Un turno que envía 8.000 tokens de prompt y recibe una respuesta de 350 tokens cuesta cerca de una décima parte de un centavo en deepseek-v4-flash, así que unos pocos dólares cubren meses de chat casual. Ese mismo turno en claude-opus-4-7 cuesta aproximadamente 25 veces más, por eso la mayoría usa un modelo barato para el día a día y guarda los modelos premium para las escenas que de verdad les importan. Una sola clave de gateway cubre toda esta tabla. APIsRouter es un gateway compatible con OpenAI con facturación por uso y sin suscripción: pagas en /topup sin crear una cuenta, la clave llega por correo, tu primera recarga suma un +100% adicional a tu saldo, los modelos globales tienen un precio 20% por debajo de las tarifas oficiales, y los modelos chinos quedan por debajo de sus precios oficiales.

Precios de catálogo en USD. kimi-k2.6 y MiMo también están disponibles en el catálogo.
ModeloEntrada / 1M tokensSalida / 1M tokens
deepseek-v4-flash$0.126$0.252
deepseek-v4-pro$0.3915$0.783
glm-5$0.514$2.314
gemini-3.5-flash$1.20$7.20
claude-sonnet-4-6$2.40$12.00
claude-opus-4-7$4.00$20.00
gpt-5.5$4.00$24.00
grok-4.5$1.60$4.80

Preguntas frecuentes

¿Qué URL de API pongo en SillyTavern?

Solo la URL base, que termina en /v1. Para APIsRouter es https://api.apisrouter.com/v1. SillyTavern añade /chat/completions por su cuenta, así que escribir la ruta completa de completions rompe la conexión con un 404.

¿Hay una API gratis para SillyTavern?

SillyTavern en sí es software libre y gratuito. El acceso a modelos alojados se factura por token, aunque algunos proveedores ofrecen niveles gratuitos con límites de tasa y colas ajustados. Ejecutar un modelo local con KoboldCpp es gratis si tu hardware lo aguanta. En la práctica, modelos alojados económicos como deepseek-v4-flash cuestan una fracción de centavo por mensaje, algo lo bastante cerca de gratis para uso casual sin el dolor de las tasas de límite.

¿Por qué mi lista de modelos de SillyTavern está vacía?

La llamada de Connect a /v1/models falló. Comprueba que la URL termine en /v1 sin ruta ni espacios extra, que la clave esté pegada limpia, y que la fuente sea Custom (OpenAI-compatible) y no OpenAI a secas. Prueba con curl contra /v1/models para ver el error real del proveedor.

¿Debo usar Chat Completion o Text Completion en SillyTavern?

Chat Completion para cualquier API alojada compatible con OpenAI. Text Completion es para backends locales como KoboldCpp y text-generation-webui que reciben una cadena de prompt en bruto. Elegir Text Completion contra un endpoint de chat alojado causa errores o un formato roto.

¿Qué modelo es mejor para roleplay en SillyTavern?

Empieza con deepseek-v4-flash, el valor por defecto habitual de la comunidad para chats largos a bajo coste. Pasa a deepseek-v4-pro para tarjetas complejas, prueba GLM-5 o Kimi K2.6 para una voz de prosa distinta, y usa Claude para la escritura creativa SFW de mayor calidad. Grok encaja con temáticas de ficción maduras bajo la política publicada de xAI.

¿Mi clave de API está segura en SillyTavern?

Las claves se guardan localmente en el secrets.json de SillyTavern en tu máquina y solo se envían al host de API que configuraste. No compartas capturas del panel de conexión ni archivos de configuración exportados, y rota la clave si sospechas que se filtró.