Cómo usar la API de DeepSeek en SillyTavern: endpoint personalizado

Configuración en cinco pasos

La pregunta de cómo usar la API de deepseek en sillytavern se reduce a un hecho: SillyTavern puede comunicarse con cualquier endpoint compatible con OpenAI, así que solo debes proporcionar una URL, una clave y un ID de modelo. Ten en cuenta que este servicio no es la API oficial de DeepSeek. Aloja un único modelo de pesos abiertos con el ID uncensored, ejecutado por un proveedor independiente y ajustado para responder sin rechazos de contenido para uso adulto lícito.

1. Crea una cuenta y abre la página de claves de API. Copia una clave. Los nuevos usuarios pueden reclamar $0,50 de crédito de prueba con un solo clic, sin necesidad de tarjeta, válido por 7 días.
2. En SillyTavern, abre la pestaña API Connections (el icono de enchufe en la barra superior).
3. Establece el tipo de API en Chat Completion. Luego establece la fuente de Chat Completion en Custom (compatible con OpenAI).
4. En el campo de endpoint personalizado ingresa https://api.deepseekapi.top/v1. Pega tu clave en el campo de clave de API. En el campo de ID del modelo ingresa uncensored.
5. Presiona Connect. Una luz de estado verde y un nombre de modelo indican que la conexión funciona.

Los nombres de las etiquetas varían ligeramente entre versiones de SillyTavern, pero la idea se mantiene: modo Chat Completion, fuente Custom, endpoint, clave, modelo. Obtén la clave desde la página de clave de API.

Si falla la conexión

Verifica estos puntos en orden. La mayoría de las fallas se deben a uno de ellos.

• Forma de URL incorrecta. El endpoint termina en /v1. No agregues /chat/completions.
• Fuente incorrecta. El modo Text Completion usa un formato de petición diferente. Esta API sirve POST /v1/chat/completions y GET /v1/models, así que usa Chat Completion.
• Clave pegada con espacios. Pégala de nuevo y busca un espacio al final.
• El servidor no tiene acceso a internet. Si ejecutas SillyTavern en un servidor doméstico o en un contenedor, la máquina necesita acceso HTTPS saliente.

Para separar un problema de SillyTavern de un problema de la clave, prueba la clave desde una terminal:

Copycurl https://api.deepseekapi.top/v1/models   -H "Authorization: Bearer YOUR_KEY" | grep uncensored

Una lista JSON con uncensored significa que la clave es válida. Para verificar la ruta de chat en sí:

Copycurl https://api.deepseekapi.top/v1/chat/completions   -H "Authorization: Bearer YOUR_KEY"   -H "Content-Type: application/json"   -d '{"model": "uncensored", "messages": [{"role": "user", "content": "Say hello in one sentence."}]}'

Configuraciones importantes para el roleplayeplay

Streaming

Activa el streaming en el panel de Chat Completion. La API envía tokens vía SSE a medida que se generan, así que las respuestas aparecen mientras se escriben. Una petición en streaming ocupa una de tus ranuras de concurrencia hasta que finalice el flujo. Una clave completa permite 8 a la vez, una clave de prueba permite 2.

Tamaño del contexto

El modelo tiene una ventana de 100.000 tokens, incluyendo prompt y completion. No tienes que usarla toda. SillyTavern envía la tarjeta del personaje, la personalidad, las entradas del libro de lore y tanto historial de chat como quepa en el límite que establezcas, en cada mensaje. Un límite menor significa una factura menor y respuestas más rápidas. Para la mayoría de los chats, 16k a 32k tokens es suficiente.

Longitud máxima de respuesta

Establece un límite de respuesta razonable, como 400 a 600 tokens, para que una respuesta no se convierta en un ensayo. La API no requiere max_tokens, pero un límite protege tu crédito de salidas descontroladas.

Muestreo

La temperatura, top_p, secuencias de parada, semilla y las penalizaciones se pasan al modelo. Un punto de partida común para chats de personajes es temperatura 0,8 a 1,0 y top_p alrededor de 0,9. Cambia un valor a la vez. Si un personaje repite frases, aumenta un poco la penalización de frecuencia o presencia en lugar de la temperatura.

Secuencias de parada

Si el modelo empieza a escribir las líneas del usuario también, añade el nombre del usuario seguido de dos puntos como secuencia de parada. Esto se pasa al modelo.

Lista de verificación para la primera ejecución

Antes de cargar un personaje favorito, ejecuta un chat de prueba corto para asegurarte de que la conexión está sana.

1. Crea un personaje en blanco o usa la tarjeta de asistente predeterminada.
2. Envía "Responde con la palabra ready". La respuesta debe llegar en uno o dos segundos y aparecer en streaming a medida que se genera.
3. Abre la consola de SillyTavern o el registro de red si no aparece nada. Un 401 significa que la clave es incorrecta, un 404 significa que la URL o el ID del modelo son incorrectos, y un 429 significa que se alcanzó un límite.
4. Verifica tu saldo. Cada respuesta incluye un encabezado X-Balance-USD, así que puedes verificar que el crédito disminuye en una pequeña cantidad por mensaje.
5. Solo entonces carga tu tarjeta de personaje real y tu libro de lore.

Si la respuesta está vacía o se corta a mitad de frase, revisa primero la configuración de longitud de respuesta. Un límite establecido demasiado bajo termina la respuesta antes, y la frase incompleta no es culpa del modelo.

Moverse entre perfiles preestablecidos

SillyTavern mantiene los perfiles de muestreo separados del perfil de conexión. Vale la pena guardar un perfil para escritura narrativa, con una temperatura más alta, y otro para respuestas cortas y factuales, con una temperatura más baja. Cambiar el perfil no afecta el endpoint ni la clave.

Cuánto cuesta una sesión de roleplay

El precio es $0,15 por 1M de tokens de entrada y $0,50 por 1M de tokens de salida, desde crédito prepago sin suscripción. Debido a que el historial se reenvía, la entrada es la parte mayor. Trabaja a través de un chat con un prompt de 20.000 tokens por mensaje y una respuesta de 400 tokens:

• Entrada: 20.000 × $0,15 / 1.000.000 = $0,003
• Salida: 400 × $0,50 / 1.000.000 = $0,0002
• Total: $0,0032 por mensaje

Así que 100 mensajes cuestan $0,32. Ahora compara una ventana de contexto recortada de 8.000 tokens con la misma respuesta: 8.000 × $0,15 / 1.000.000 = $0,0012, más $0,0002, lo que hace $0,0014 por mensaje y $0,14 por 100. Recortar el contexto cuesta menos de la mitad para el mismo número de turnos.

Los $0,50 de prueba cubren aproximadamente 156 mensajes en el tamaño mayor (0,50 / 0,0032 = 156,25) o aproximadamente 357 en el tamaño menor (0,50 / 0,0014 = 357,1). Las peticiones fallidas o rechazadas no se cobran, y el crédito no caduca. Consulta la página de precios para ver montos de recarga, bonificaciones y métodos de pago; se aceptan tanto tarjeta (Visa, Mastercard, Apple Pay, Google Pay) como cripto (USDT en TRC20, USDC en Base).

Personajes, seguridad y la regla estricta

El modelo está ajustado para ficción, roleplay y apps de compañía para adultos. No es un filtro de seguridad general y no decide qué es adecuado para ti. Ese es tu trabajo: mantén tus tarjetas y chats para uso adulto lícito.

El único límite fijo es que no se permite contenido sexual con menores de edad, y ningún prompt cambia eso. Mantén las edades de los personajes claramente adultas en tus tarjetas.

Algunos hábitos prácticos ayudan a la calidad de un chat:

• Coloca los datos clave del personaje en la parte superior de la tarjeta, no enterrados al final.
• Usa un prompt de sistema corto que defina el estilo del narrador y la longitud de las respuestas.
• Resume las partes antiguas del chat con la función de resumen de SillyTavern en lugar de mantenerlas para siempre.
• Mantén las entradas del libro de lore cortas y activadas por palabras clave para que solo se incluyan en el prompt cuando sea necesario.

Los prompts no se usan para entrenamiento. Lee la documentación quickstart para ver los encabezados de respuesta, incluido X-Balance-USD, que muestra tu saldo restante.

Usar un personaje como backend de una aplicación de compañía

Algunas personas usan SillyTavern como interfaz para un personaje de compañía de larga duración para adultos. Se aplican las mismas reglas que para cualquier chat. Mantén la personalidad consistente escribiéndola como un bloque fijo corto y deja que la función de resumen gestione los eventos antiguos. Los largos intervalos entre sesiones no cuestan nada, porque el crédito no caduca y no hay suscripción.

Si más tarde construyes tu propia aplicación en lugar de usar SillyTavern, puedes llamar al mismo endpoint desde código. La documentación quickstart muestra ejemplos con curl, Python y Node con la misma URL base y ID de modelo, de modo que un prompt que funciona en SillyTavern se puede migrar directamente.

Límites de peticiones en un chat activo

Un chat individual rara vez alcanza los límites. Los chats grupales, los swipes y varias pestañas abiertas pueden. El servicio responde con HTTP 429 y el código rate_limited cuando superas el límite de peticiones por minuto (60 en una clave de prueba, 300 en una clave completa) y concurrency cuando hay demasiadas peticiones en curso (2 en prueba, 8 en completa).

En caso de sobrecarga breve también recibes un 429 con la cabecera Retry-After: 5. Esperar cinco segundos y volver a enviar es la respuesta correcta. Si ves esto en una clave de prueba, cierra las pestañas adicionales o detén un swipe antes de iniciar otro.

Más guías

• Cómo usar la API de DeepSeek en Cursor: Configuración de URL base personalizada
• Ejemplo de API de DeepSeek en Python: chat, streaming, herramientas
• Clave de API de DeepSeek: acceso a LLM sin censura