ES ▾
Obtener clave de API

Configuración de API de SillyTavern: Cómo conectarse de forma compatible con OpenAI

En la configuración de la API de SillyTavern, es fácil confundirse con el endpoint, la clave, el nombre del modelo y los valores de la ventana de contexto. Te los explicamos junto con los comandos de verificación.

Fecha de actualización

Puntos clave

  • Selecciona el modo personalizado de Chat Completion (compatible con OpenAI)
  • URL: https://api.mukenetsuapi.com/v1, nombre del modelo: uncensored
  • El contexto puede llegar a 100.000, pero es práctico limitarlo por coste y velocidad
  • 401 indica un problema con la clave, 404 con la URL, y 429 hace sospechar que se ha excedido el límite de concurrencia o de peticiones.
Imagen conceptual de la conexión API de SillyTavern: una máscara de escenario y un enchufe de servidor unidos con un cable brillante

Prepara los 3 requisitos previos

La configuración de sillytavern api es breve; la mayoría de los errores son por valores incorrectos. Ten a mano estos 3 elementos.

  • Clave de API: Emítela en la página de obtención de clave de API. Tras registrarte, recibe $0,50 de crédito de prueba con un clic.
  • Base URL: https://api.mukenetsuapi.com/v1
  • Nombre del modelo: uncensored

SillyTavern es un frontend que permite añadir endpoints compatibles con OpenAI. Como esta API es compatible, no necesitas usar el endpoint oficial de OpenAI; regístrala como un endpoint personalizado.

Pasos de conexión

Los textos del menú varían según la versión. Aquí describimos el flujo general. Si difiere, consulta también la documentación oficial de SillyTavern.

  1. Abre «API Connections» (icono de enchufe) en la parte superior.
  2. Selecciona «Chat Completion» como tipo de API.
  3. En la lista de fuentes, elige la conexión personalizada compatible con OpenAI (Custom).
  4. Introduce https://api.mukenetsuapi.com/v1 en la URL del endpoint. No añadas /chat/completions al final.
  5. Pega la clave emitida en el campo de clave de API. Asegúrate de que no haya espacios al inicio o final.
  6. Establece el nombre del modelo en uncensored. Si puedes seleccionarlo de la lista, hazlo; si lo escribes manualmente, escríbelo tal cual.
  7. Pulsa el botón de conexión y verifica que aparezca un mensaje de éxito.

Antes de conectar, verifica en la terminal que la clave y la URL son correctas para facilitar la depuración.

curl https://api.mukenetsuapi.com/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "uncensored", "messages": [{"role": "user", "content": "こんにちは"}], "max_tokens": 50}'

Si recibes una respuesta, la clave, URL y modelo son correctos. Si SillyTavern falla en este estado, el problema está en la entrada de la aplicación.

Definir contexto y longitud de respuesta

La ventana de contexto de esta API permite hasta 100.000 tokens combinando prompt y salida. No recomendamos usar el tamaño máximo de contexto en SillyTavern, ya que cada entrada reenvía la configuración del personaje, el lore y el historial, aumentando el coste por entrada.

Ejemplo de cálculo de coste

Si usas hasta 16.000 tokens de contexto y la respuesta tiene 300 tokens, el coste por mensaje es:

  • Entrada: 16.000 ÷ 1.000.000 × $0,15 = $0,0024
  • Salida: 300 ÷ 1.000.000 × $0,50 = $0,00015
  • Total: $0,00255

100 mensajes cuestan $0,255. Si reduces la ventana de contexto a 8.000, la entrada será aproximadamente la mitad. Consulta la página de precios para ver los detalles de la tarifa.

Orientativo

Si no se trata de historias largas o escenas con muchas personas, es recomendable empezar con 8.000 a 16.000 tokens y aumentar si notas que el personaje olvida eventos pasados. La longitud máxima de respuesta debe ajustarse a la longitud que desees leer en una sola respuesta. max_tokens es opcional, pero es recomendable establecer un límite en SillyTavern para evitar respuestas demasiado largas.

Enfoque de los ajustes de muestreo

temperature, top_p, stop, seed y las penalizaciones varias se pasan directamente a la API. Puedes ajustarlas con los presets de SillyTavern.

  • Repetición de frases: aumenta ligeramente las penalizaciones de frequency o presence.
  • Respuesta dispersa: baja la temperatura.
  • Monótono: sube ligeramente la temperatura.
  • Para comparar: fija seed y cambia un valor a la vez.

Los nombres de los campos del preset varían según la versión de SillyTavern. Si los ajustes no se aplican, verifica si el tipo de conexión que usas es compatible con ese campo o consulta la documentación de SillyTavern.

Errores comunes y soluciones

SíntomaPosible causaSolución
401Clave incorrecta o con espaciosVuelve a pegar la clave y pruébala con curl.
404URL incorrectaVerifica que la URL termine con /v1.
Modelo no encontradoOrtografía del nombre del modeloIntrodúcelo en minúsculas: uncensored.
429 (concurrency)Demasiadas peticiones simultáneasReduce los deslizamientos rápidos o la generación simultánea en chats grupales.
429 (rate_limited)Superado el límite de peticiones por minutoEspera un poco.
429 (con Retry-After: 5 incluido)Congestión temporalEspera 5 segundos y vuelve a intentarlo.

El límite de claves completas es 8 simultáneas y 300 por minuto; la clave de prueba permite 2 simultáneas y 60 por minuto. Una respuesta con streaming ocupa 1 slot de conexión simultánea hasta que termina. Si ejecutas un chat grupal con la clave de prueba, los slots se llenan rápidamente.

Puedes verificar si tienes suficiente saldo con el siguiente comando.

curl https://api.mukenetsuapi.com/v1/balance \
  -H "Authorization: Bearer YOUR_API_KEY"

También puedes leerlo en el encabezado de respuesta X-Balance-USD. Para ver la lista de modelos, usa GET /v1/models.

curl https://api.mukenetsuapi.com/v1/models \
  -H "Authorization: Bearer YOUR_API_KEY"

Notas de uso

Esta API es solo para texto. Si quieres usar las funciones de generación de imágenes o audio de SillyTavern, necesitarás otro servicio. El contenido está pensado para ficción, como novelas, roleplay o aplicaciones de compañía, dentro del uso legal para adultos. No se puede generar contenido sexual con menores de edad, independientemente de la configuración. Los prompts no se usan para el entrenamiento del modelo.

Para parámetros más detallados, consulta la documentación. Los pagos se realizan en USDT (TRC20) o USDC (Base) en cantidades enteras de $20 a $500.

Otras guías

Preguntas frecuentes

¿Qué nombre de modelo usar en SillyTavern?

uncensored. Escríbelo en minúsculas y tal cual.

¿Es necesario añadir /chat/completions al final de la URL?

No. La base URL debe terminar en /v1; la aplicación añade el resto de la ruta.

¿Es suficiente con la clave de prueba?

Es suficiente para verificar la conexión y conversaciones cortas. Sin embargo, la clave de prueba tiene un límite de 2 simultáneas y 60 por minuto, y su validez es de 7 días. Si usas chats grupales, recarga una clave normal.

¿También se pueden generar imágenes?

No. Esta API es solo para texto y no admite la generación de imágenes, audio ni video.

¿Cuál debería ser el tamaño de la ventana de contexto?

El máximo es de 100.000 tokens, pero lo más realista es empezar con 8.000 a 16.000. Cuanto mayor sea, mayor será la entrada de cada petición y más costosa será la operación.

La clave de API se obtiene con 1 formulario

Crear la cuenta, copiar la clave y cambiar la base URL. Con esto ya está todo configurado.

Obtener clave de API