SillyTavern

SillyTavern puede usar SpicyAPI de dos maneras. La primera es su conexión de chat habitual: SillyTavern envía tus mensajes a un modelo de chat de SpicyAPI mediante la fuente Custom (OpenAI-compatible). La segunda es la extensión de SpicyAPI, que añade los comandos /spicy-img y /spicy-video y un botón Animate para crear imágenes y videos cortos sin salir del chat.

Puedes usar cualquiera de las dos por separado. Ambas usan la misma cuenta, el mismo saldo y los mismos precios que el resto de SpicyAPI, y solo pagas por lo que ejecutas. La extensión es gratuita y de código abierto (MIT) en github.com/spicyapi-ai/sillytavern-spicyapi.

Antes de empezar

• SillyTavern 1.19.0 o posterior. Los pasos de esta página se comprobaron con la versión 1.19.0 el 2026-10-06. Las etiquetas de los menús pueden cambiar en otras versiones.
• git en el equipo que ejecuta SillyTavern, solo si quieres la extensión. SillyTavern lo usa para descargar extensiones.
• Una clave de API. Las claves empiezan por sk-spicy-. Consulta Autenticación para ver las restricciones que puedes aplicar a una clave y Configura tu cuenta si aún no tienes cuenta.
• Saldo. Cada solicitud se paga con tu saldo prepago en USD. Consulta Facturación.

Conecta el chat de SillyTavern con SpicyAPI

Quien envía la solicitud de chat es el servidor de SillyTavern, no tu navegador, así que no necesitas configurar nada más por tu parte.

Elige un modelo de chat

Los ids de los modelos de chat terminan en /chat. El menú desplegable Available Models se rellena con la lista completa de modelos de SpicyAPI, así que también muestra modelos de imagen, video y audio, que no pueden chatear. Los modelos de chat aparecen primero: elige uno al principio de la lista, o escribe o pega un id /chat en Enter a Model ID.

Para ver todos los modelos de chat y lo que acepta cada uno, consulta los modelos de chat en el sitio o llama a GET https://api.spicyapi.ai/v1/models con tu clave (consulta Modelos). Cada entrada de chat incluye context_length, max_output_tokens y supported_parameters.

Para roleplay, el ranking de roleplay clasifica los modelos de chat según la coherencia del personaje y la libertad con la que escriben. Algunos modelos de chat no tienen censura y otros filtran contenido; el catálogo marca el nivel de política de cada modelo.

Ajustes recomendados

Los ajustes de muestreo que el modelo elegido no admite, como temperature, top P, frequency penalty y presence penalty, se ignoran en lugar de rechazarse. SpicyAPI enumera los que omitió en el encabezado de respuesta X-Spicy-Ignored-Params. Puedes dejar los deslizadores de SillyTavern como están.

Esfuerzo de razonamiento

El menú Reasoning Effort de SillyTavern no se envía a los modelos de SpicyAPI. Si quieres establecerlo, añádelo tú mismo y solo para un modelo cuyo supported_parameters incluya reasoning_effort:

1. Haz clic en Additional Parameters, debajo del botón Connect.
2. En Include Body Parameters, añade una línea, por ejemplo:

reasoning_effort: low

Los valores permitidos varían según el modelo. Un nivel que el modelo no ofrece se cambia por el más cercano que sí ofrece (se nombra en el encabezado de respuesta X-Spicy-Adjusted-Params), y en un modelo sin niveles de razonamiento la línea se ignora. Consulta primero la entrada del modelo en la lista de modelos. Si la respuesta llega vacía o cortada, aumenta Response (tokens) o reduce el esfuerzo.

Imágenes en el chat

Con Send inline media activado, SillyTavern adjunta las imágenes del chat a cada solicitud posterior. Un modelo que no puede leer imágenes rechaza la solicitud con un 400 y, como la imagen sigue en el chat, todos los mensajes siguientes también fallan. Desactiva Send inline media para los modelos solo de texto u oculta el mensaje que contiene la imagen.

Los videos del chat no se envían al modelo.

Ajustes que un modelo rechaza

Algunos ajustes se rechazan cuando el modelo no los admite, porque cambian la respuesta en lugar de solo afinarla: Multiple swipes per generation por encima de 1 (n), los presets de Logit Bias y Request token probabilities. Si una solicitud falla con un mensaje que nombra uno de ellos, desactiva ese ajuste. El texto del error nombra el campo.

Custom Stopping Strings funcionan en todos los modelos. Un modelo sin secuencias de parada (los modelos Grok, por ejemplo) las ignora, y un modelo que admite menos de las que definiste conserva las primeras; los encabezados de respuesta X-Spicy-Ignored-Params y X-Spicy-Adjusted-Params indican cuáles. Un valor de deslizador fuera del rango de un modelo, como una temperatura de 1.5 en un modelo que llega hasta 1, se baja al límite de la misma manera.

La extensión de SpicyAPI

La extensión crea imágenes y videos cortos desde dentro de un chat. Instálala una vez, añade tu clave y elige modelos.

Comandos

Argumentos con nombre que puedes añadir a los comandos:

• model=<id> usa un modelo solo para esta ejecución. Pulsa Tab después de model= para ver la lista.
• edit=true abre el editor del prompt aunque hayas escrito uno.
• quiet=true guarda el resultado y devuelve su ruta sin publicarlo, para Quick Replies y STscript.
• avatar=true o avatar=false (solo imágenes) anula el ajuste "usar el avatar del personaje".

/spicy-img a lighthouse on a cliff at dusk, wide shot
/spicy-video waves rolling onto a beach at sunrise
/spicy-video image=last slow push-in, hair moving in the wind

El menú de la varita junto al campo de entrada del chat incluye SpicyAPI picture, SpicyAPI video y SpicyAPI: animate last picture.

Animate

Cada imagen del chat tiene un icono de película entre sus controles, y los mensajes con una imagen tienen el mismo icono en su menú .... Convierte esa imagen en un clip de video con tu modelo de imagen a video y añade el clip al mismo mensaje.

Prompts

Si no escribes ningún prompt, el modelo de chat al que estás conectado redacta uno a partir de la escena actual. Con Let me read and edit the prompt before generating activado (el valor por defecto), se abre una ventana que muestra el modelo, el precio exacto y el prompt tal como está escrito. Puedes esperar, escribir el tuyo o pulsar de nuevo Write from the scene. La extensión no incluye prompts, presets ni estilos; las palabras salen de ti o de tu modelo de chat.

Con los modelos que aceptan una imagen de referencia, puedes usar el avatar del personaje para que la imagen se parezca a él.

Deja que la IA muestre imágenes

Desactivado por defecto. Actívalo en Let the AI show pictures en el panel de SpicyAPI y elige cómo pide el modelo de chat una imagen. Puedes usar cualquiera de las dos formas, o ambas:

Las imágenes automáticas tienen sus propios límites, además de los de cada ejecución que se indican abajo:

• como máximo una imagen cada pocas respuestas por chat (3 por defecto), y una solicitud rechazada o fallida también inicia la espera;
• un límite diario para las imágenes automáticas en este navegador ($0.50 por defecto);
• por encima de tu importe de confirmación, o bien Ask me first (por defecto, mostrando la descripción y el precio) o bien Skip the picture.

Las ejecuciones automáticas solo crean imágenes, nunca videos, y las imágenes se ocultan a la IA como cualquier otro resultado. Mientras la herramienta está activada, su definición se envía con cada solicitud de chat, lo que cuesta unos pocos tokens en tu API de chat. El comportamiento completo está en el README de la extensión.

Precios y límites

Antes de cada ejecución, la extensión pide una cotización a SpicyAPI y la muestra en dólares estadounidenses. Las cotizaciones son gratuitas.

El panel también muestra lo que ha gastado esta sesión del navegador. Para un límite estricto que funcione en todas partes, pon un límite de gasto diario en la propia clave. Consulta Autenticación.

Una ejecución sigue en SpicyAPI si pulsas Stop waiting o cierras la página, y se cobra si tiene éxito. Recógela más tarde con /spicy-task <task id>. Las ejecuciones fallidas no se cobran, salvo en los pocos modelos cuya página indica que las solicitudes rechazadas se facturan. Consulta Facturación.

Dónde se guardan tu clave y los archivos

• Tu clave se guarda en texto plano en el archivo de ajustes de SillyTavern, en el equipo que ejecuta SillyTavern (data/<user>/settings.json, bajo extension_settings.spicyapi). Otras extensiones de SillyTavern pueden leerla. Si usas Connect chat, la clave también se guarda en el archivo de secretos de SillyTavern como clave del endpoint Custom. Por eso conviene crear una clave exclusiva con un límite de gasto.
• Los resultados se descargan y se guardan en la carpeta de imágenes de SillyTavern (data/<user>/user/images/<character>/spicyapi_<task id>.png o .mp4) y después se adjuntan al chat. Los resultados nuevos se ocultan a la IA por defecto, de modo que la siguiente solicitud del chat no envía una imagen a un modelo que no puede leerla. Activa Let the AI see generated pictures and videos para cambiarlo.
• Lo que sale de tu equipo: el prompt, los ajustes del modelo y cualquier imagen de referencia van a api.spicyapi.ai. Cuando tu modelo de chat redacta el prompt, el contexto del chat va a la API de chat a la que SillyTavern esté conectado, como con cualquier otro mensaje.
• SpicyAPI conserva los archivos generados durante un tiempo limitado. Consulta Retención.

Si cambias de chat mientras algo se está generando, el resultado se guarda pero no se añade al chat, y la extensión te indica dónde está.

Ruta de conexión

Por defecto, la extensión se comunica con https://api.spicyapi.ai directamente desde tu navegador. Si tu red o tu navegador lo bloquean, abre Connection en el panel y elige Auto (prueba directamente y, si falla, recurre al proxy CORS de SillyTavern) o Through SillyTavern's CORS proxy.

El proxy está desactivado por defecto. Actívalo estableciendo enableCorsProxy: true en el config.yaml de SillyTavern (o inicia SillyTavern con --corsProxy) y reinicia. No se puede combinar con la autenticación básica de SillyTavern (basicAuthMode), que rechaza las solicitudes que llevan una clave de API. En ese caso, usa la ruta directa.

Solución de problemas

Los errores de SpicyAPI terminan con un request_id o un ID de tarea. Indícalo al soporte y la solicitud se podrá localizar con exactitud. Los códigos de error se explican en Errores.