Guía de integración de la API de SillyTavern: Conecta GPTProto y comienza a jugar roles

Paso 1: Instalar e iniciar SillyTavern

SillyTavern ejecuta la interfaz de chat, las tarjetas de personajes y la configuración de prompts en tu computadora. Un modelo conectado genera las respuestas. La documentación oficial del proyecto lo describe como un frontend gratuito y de código abierto.

Prepara Node.js LTS, Git, una cuenta de GPT Proto con saldo de API disponible y un ID de modelo. La inferencia en la nube a través de GPT Proto no requiere descargar pesos de modelos ni ejecutar un modelo en tu GPU.

Instalación en macOS

Descarga la versión LTS desde la página de descarga de Node.js, selecciona macOS y utiliza su instalador si prefieres una instalación gráfica.

Elige la versión LTS actual para tu sistema operativo.

Abre la Terminal y verifica Git:

git --version

Instala Git si es necesario, luego ejecuta:

cd ~
git clone https://github.com/SillyTavern/SillyTavern -b release
cd SillyTavern
bash start.sh

El primer inicio instala las dependencias. Mantén la terminal abierta mientras usas SillyTavern y abre la dirección local que aparece allí si el navegador no se inicia automáticamente. Estos comandos siguen las instrucciones oficiales de instalación para macOS.

El primer inicio descarga las dependencias necesarias.

Para iniciarlo de nuevo más tarde:

cd ~/SillyTavern
bash start.sh

Instalación en Windows

Instala Node.js LTS y Git para Windows. Crea una carpeta como C:\AI, ábrela en el Explorador de archivos, escribe cmd en la barra de direcciones y presiona Enter. Ejecuta:

git clone https://github.com/SillyTavern/SillyTavern -b release

Abre la carpeta SillyTavern descargada y haz doble clic en Start.bat. Deja su consola abierta mientras chateas. La guía oficial de Windows recomienda evitar carpetas controladas por Windows como Program Files y ejecutar el archivo de inicio sin permisos de administrador.

Paso 2: Conecta SillyTavern a GPT Proto

Inicia sesión en GPT Proto y abre la página del modelo GLM-5.3. Su sección de Uso de API proporciona el identificador del modelo y una entrada para Crear clave de API. Crea o selecciona tu clave, verifica la tarifa actual y prepara suficiente saldo para una pequeña prueba.

En SillyTavern, abre Conexiones de API, usando el ícono de enchufe en la barra superior. Ingresa:

Pega la clave directamente en el campo de clave. No añadas Bearer, comillas ni un encabezado HTTP completo ahí.

Las instrucciones oficiales de endpoint personalizado especifican una URL base sin /chat/completions; SillyTavern añade ese sufijo. Para esta conexión, el campo de endpoint debe terminar en /v1.

Si seguiste anteriormente nuestra guía de configuración de API de Janitor AI, verifica esta diferencia: la URL de proxy de Janitor usa la dirección https://gptproto.com/v1/chat/completions completa. Copiar esa dirección completa en el campo de URL base de SillyTavern le daría la entrada incorrecta.

Haz coincidir la fuente, la URL base, la clave y el ID del modelo con los campos anteriores.

Haz clic en Conectar, luego en Mensaje de prueba. También puedes enviar Hola desde la pantalla de bienvenida. El tutorial produjo la respuesta que se muestra a continuación.

Un mensaje básico confirma que la conexión puede generar una respuesta.

Una lista vacía de Modelos disponibles no significa necesariamente que la generación no esté disponible. Ingresa el ID exacto manualmente cuando el descubrimiento de modelos no esté disponible. Para cambiar de modelo más tarde, usa otro ID de modelo de texto de GPT Proto compatible y prueba de nuevo; las características del modelo y los parámetros aceptados pueden variar.

Paso 3: Importa una tarjeta de personaje o crea la tuya

Una conexión de API funcional suministra el modelo. La tarjeta de personaje suministra la identidad, la voz y la situación inicial.

Importa una tarjeta de personaje existente

Abre Personajes → Importar personaje, selecciona el archivo de tarjeta descargado y elige el personaje importado para comenzar a chatear. También puedes explorar personajes a través de Extensiones → Descargar extensiones y activos.

Para tarjetas PNG, descarga el archivo original. Un retrato normal o una captura de pantalla no contiene una definición de personaje utilizable a menos que esos datos estén incrustados en la imagen. Las preguntas frecuentes oficiales explican las importaciones de PNG no válidas, incluidos los casos en los que guardar o procesar una imagen elimina sus datos incrustados.

Crea a Noah Bennett a partir de texto

Elige Crear nuevo personaje. Comienza con el Nombre, la Descripción y el Primer mensaje; podrás añadir campos avanzados más tarde. La descripción le indica al modelo información sobre el personaje. El primer mensaje establece la escena inicial y demuestra el estilo que deseas. La guía de diseño de personajes explica ambos campos.

Usa el editor de personajes para la identidad y la escena inicial de la IA.

Establece el Nombre como Noah Bennett. Pega este ejemplo original en la Descripción. {{char}} se refiere al personaje y {{user}} a la identidad de usuario que seleccionaste.

Estás interpretando a {{char}}, Noah Bennett, un hombre de 25 años con un físico musculoso, una sonrisa fácil y una personalidad cálida y afectuosa.

APARIENCIA
Noah mide 188 cm, con hombros anchos, brazos fuertes, un pecho definido y piernas fuertes desarrolladas tras años de entrenamiento de fuerza. Tiene el cabello castaño oscuro ligeramente despeinado, cálidos ojos color avellana, una barba incipiente y un hoyuelo que aparece cuando sonríe. Su ropa habitual son camisetas ajustadas, pantalones deportivos cómodos y tenis. Su voz es grave y cálida, y se ríe con facilidad.

PERSONALIDAD
Noah es un encanto con una confianza juguetona. Es atento, físicamente expresivo y se siente cómodo mostrando afecto. Disfruta haciendo que {{user}} sonría mediante bromas suaves, gestos considerados y cumplidos sinceros. Su atractivo proviene de la combinación de su imponente físico y su corazón sorprendentemente tierno.

Tiene sus propias opiniones, amistades, ambiciones y días malos ocasionales. A veces oculta el nerviosismo tras una broma y se pone adorablemente nervioso cuando {{user}} lo atrapa siendo sentimental. Puede admitir errores y reírse de sí mismo.

ANTECEDENTES
Noah trabaja como entrenador de fuerza y espera abrir un pequeño gimnasio en el vecindario. Fuera del trabajo, le gusta cocinar, hacer senderismo, las comedias románticas terribles y experimentar con recetas de panqueques. Se toma el entrenamiento en serio, pero nunca juzga a las personas por sus cuerpos o niveles de condición física.

RELACIÓN CON {{user}}
Noah y {{user}} son vecinos amigables que recientemente han comenzado a pasar más tiempo juntos. Él se siente atraído por {{user}} y hace evidente su interés a través de la atención, el coqueteo juguetón y las invitaciones para hacer cosas cotidianas juntos. Deja que su cercanía se desarrolle a través de interacciones reales.

ESTILO DE COQUETEO
Su forma de coquetear es cálida, específica y ligeramente descarada. Puede mantener el contacto visual un poco más de tiempo, recordar una bebida favorita o admitir que encontró una excusa para pasar a saludar. Nota las respuestas de {{user}} y se ajusta de forma natural. El afecto debe sentirse bienvenido y mutuo.

ESTILO DE JUEGOS DE ROL
Mantente en el personaje de Noah durante la historia. Usa diálogos naturales, pequeños gestos físicos y detalles concretos en lugar de largas explicaciones de personalidad.
Escribe las acciones entre *asteriscos* y los diálogos entre comillas.
Por lo general, responde en uno a tres párrafos cortos, dejando espacio para que {{user}} participe.
Solo controla el habla, las acciones y los pensamientos de Noah. Deja los diálogos, decisiones y sentimientos de {{user}} al usuario.
Mantén los detalles establecidos y responde directamente a lo que acaba de suceder.
Usa un inglés natural a menos que {{user}} solicite otro idioma.

Pega esto en el Primer mensaje:

*Noah está de pie frente a tu puerta con una bolsa de gimnasio sobre un hombro ancho y una pequeña bolsa de papel en la mano. Su cabello oscuro todavía está ligeramente húmedo y su camiseta gris ajustada tiene una pequeña pizca de harina cerca del dobladillo.*

"Antes de que digas nada, sí, puedo cocinar cosas que no sean pollo con arroz".

*Levanta la bolsa de papel y aparece un hoyuelo mientras sonríe.*

"Rollos de canela. Hice demasiados." *Una breve pausa.* "Está bien, hice de más porque esperaba verte."

"Entonces… ¿estás libre para un café?"

Completa la creación del personaje y luego selecciona a Noah. Mantén las instrucciones principales en Descripción y la apertura en Primer mensaje. Las Notas del creador proporcionan metadatos para las personas que leen la tarjeta y no se utilizan para construir el prompt del modelo.

La tarjeta de Noah completada separa su identidad continua de su saludo inicial.

Configura tu propia Persona

Los personajes definen la identidad de la IA. Las personas definen la tuya. Abre Gestión de Personas, crea y selecciona una persona y, opcionalmente, añade un nombre, un avatar y una descripción siguiendo las instrucciones oficiales de Persona.

Para esta escena ficticia, una descripción breve es suficiente:

{{user}} es una persona adulta que se mudó recientemente al vecindario. Noah y {{user}} son vecinos amigables que se están conociendo. {{user}} decide sus propios diálogos, acciones, elecciones y sentimientos.

Usa detalles ficticios que quieras que el personaje conozca; no necesitas ingresar tu biografía real. Para más ideas sobre cómo escribir personajes, consulta cómo crear tu propio personaje de IA con una API.

Paso 4: Comienza tu primera conversación de juego de rol

Abre el chat de Noah y lee el saludo. En la captura de pantalla, el usuario responde sí y Noah responde: “¿Sí? Está bien. Genial”. Luego continúa con la invitación al café mediante acciones y diálogos. Esa continuación generada es la prueba de conexión útil.

Para probar un prompt más específico por tu cuenta, envía:

"¿Así que los rollos de canela eran solo una excusa para verme?"
*Miro la bolsa de papel y luego vuelvo a mirarlo.*

Verifica si la respuesta sigue la personalidad de Noah, responde a tu última entrada y deja las decisiones en tus manos. Si el estilo necesita mejorar, edita una parte de la tarjeta e intenta un chat nuevo. Evita cambiar el modelo, el prompt del personaje y varias configuraciones a la vez; tendrás menos información sobre qué fue lo que ayudó.

Opcional: Añade información del mundo (World Info) a tu personaje

La información del mundo, también llamada lorebook, añade información del entorno al prompt bajo condiciones configuradas. Para un primer experimento, añade una ubicación de la escena de Noah.

Abre World Info, crea un lorebook y añade una entrada habilitada usando la estrategia de activación por palabras clave. Usa estos valores de ejemplo:

En el panel de personaje de Noah, usa Más… → Vincular World Info o el botón del globo terráqueo de lore del personaje para asociar el lorebook con él. Luego pregunta: ¿Cómo es Corner Cafe?

La documentación de World Info explica que el contenido de la entrada es lo que ingresa al prompt; el título por sí solo no proporciona los hechos. La activación también depende de la configuración y el presupuesto disponible, y es posible que el modelo no utilice cada detalle proporcionado. Comienza con una entrada concisa y verifica su comportamiento antes de añadir un mundo extenso.

¿Cuánto cuesta SillyTavern con GPT Proto?

GLM-5.3 es el modelo utilizado para este tutorial. Elige tu modelo según tu presupuesto, la naturalidad del diálogo, la expresión emocional, la coherencia del personaje y la velocidad de respuesta. Compara candidatos con la misma tarjeta y escena inicial. Para chats diarios, incluye los costos de contexto retenido en tu presupuesto; para escenas basadas en historias, verifica si la voz se siente creíble y si el modelo te permite tomar tus propias decisiones.

SillyTavern en sí es gratuito. La generación de modelos de GPT Proto utiliza tu saldo de API. Al momento de escribir esta guía, GLM-5.3 está un 15% por debajo de sus tarifas oficiales de entrada y salida en GPT Proto:

Tarifas verificadas el 3 de noviembre de 2026. Consulta el panel de precios de GLM-5.3 para conocer las tarifas actuales y cualquier precio de caché aplicable.

Una solicitud ilustrativa con 8,000 tokens de entrada sin caché y 500 tokens de salida facturables cuesta:

(8,000 ÷ 1,000,000 × $1.19) + (500 ÷ 1,000,000 × $3.74)
= $0.01139

Este es un ejemplo de cálculo, no la factura medida de la conversación de la captura de pantalla. La salida facturable no es un conteo de palabras; utiliza el uso reportado por el proveedor, incluyendo cualquier token de razonamiento facturado como salida.

La entrada puede incluir instrucciones del personaje, Persona, lore seleccionado e historial de conversación retenido. Como explica la descripción general de la conexión API, SillyTavern ensambla estos elementos en el prompt. Un contexto retenido más largo puede aumentar el costo de una respuesta incluso cuando tu mensaje más reciente es solo sí.

¿Por qué elegir GPT Proto para tu API de SillyTavern?

GPT Proto ofrece modelos oficiales de proveedores con tarifas con descuento en modelos seleccionados, incluido GLM-5.3. Una sola clave y un saldo compartido cubren múltiples proveedores. En SillyTavern, mantén tus tarjetas de personaje y tu conexión personalizada, cambia a otro ID de modelo de chat compatible y compara sus respuestas.

Para mayor confiabilidad, los modelos principales utilizan canales ascendentes redundantes y conmutación por error automática para ayudar a reducir las interrupciones cuando un canal no está disponible. Puedes elegir entre modelos con diferentes precios y estilos conversacionales mientras mantienes tu configuración.

Antes de una sesión larga, verifica la disponibilidad del modelo, los costos de entrada/salida, la velocidad de respuesta y el manejo de datos. Comienza con una prueba pequeña y revisa el uso. La página de modelos de SillyTavern te permite explorar opciones y comparar costos.

Problemas comunes de la API de SillyTavern y sus soluciones

Comienza con un chat nuevo y un mensaje corto. Luego, identifica el síntoma y realiza la comprobación correspondiente:

Los modelos de razonamiento requieren atención especial. La guía oficial de razonamiento explica que el pensamiento puede consumir tokens de respuesta, incluso cuando está oculto. Una asignación demasiado pequeña para ese modelo puede dejar una respuesta visible vacía o incompleta. Verifica la Longitud máxima de respuesta según los requisitos del modelo en lugar de aplicar el mismo límite pequeño a todos los modelos.

Una discusión de la comunidad sobre libros de lore y respuestas vacías describe a un usuario que se recuperó después de eliminar un ajuste preestablecido y aumentar la asignación de respuesta. Ambos cambios se realizaron juntos, por lo que el informe no aísla una sola causa. Esto respalda un orden práctico de solución de problemas: haz que un chat simple funcione y luego agrega ajustes preestablecidos y lore, un cambio a la vez.

Opcional: Prueba la API fuera de SillyTavern

Con tu clave almacenada de forma privada en la variable de entorno GPTPROTO_API_KEY, este comando de shell de macOS/Linux envía una solicitud directa utilizando el formato de Chat Completions de la página del modelo:

curl --request POST "https://gptproto.com/v1/chat/completions" \
  --header "Authorization: Bearer $GPTPROTO_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "model": "glm-5.3",
    "messages": [
      {"role": "user", "content": "Reply with: API connection works."}
    ]
  }'

Verifica que la respuesta sea exitosa y contenga texto generado, no solo un indicador de conexión. Si esto funciona mientras SillyTavern falla, compara los campos y parámetros adicionales del cliente. Si ambos fallan, investiga el error de autenticación, saldo, modelo o servicio devuelto. Mantén las claves reales fuera de las publicaciones públicas de solución de problemas.