Clave de API de DeepSeek en SillyTavern: Conecta nuestra API

Configuración rápida

Para configurar una clave de API de DeepSeek en SillyTavern, una aclaración primero. Una clave emitida por la plataforma propia de DeepSeek es para el endpoint de DeepSeek. La clave que obtienes en este sitio pertenece a un servicio separado: una API independiente compatible con OpenAI que ejecuta un modelo de pesos abiertos, ajustado para responder sin filtros de contenido para uso adulto legal. No es la API oficial de DeepSeek, así que usa la clave de este sitio solo con la URL base de este sitio.

Los valores a ingresar en SillyTavern son:

• Origen: Chat Completion, luego Custom (compatible con OpenAI)
• Endpoint personalizado (URL base): https://api.deepseekapikey.com/v1
• Clave de API: la clave de tu cuenta
• ID de modelo: uncensored

SillyTavern se actualiza a menudo y las etiquetas del menú pueden cambiar ligeramente entre versiones, así que coincide por significado si un nombre difiere. El resto de esta página explica cada paso y la configuración que importa para chats largos de personajes.

Paso a paso en la interfaz

1. Obtén una clave. Regístrate en la página de clave de API con Google o con correo electrónico y contraseña. Los nuevos usuarios pueden reclamar $0,50 de crédito de prueba con un clic, válido por 7 días, uno por persona, sin tarjeta.
2. Abre el panel de conexión API. En SillyTavern, haz clic en el icono de enchufe en la parte superior para abrir Conexiones API.
3. Selecciona el tipo de API. Elige Chat Completion en el menú desplegable de API. Los modos de finalización de texto están pensados para backends que toman prompts en crudo; esta API usa mensajes de chat.
4. Selecciona el origen. En la lista de Orígenes de Chat Completion, elige Custom (compatible con OpenAI).
5. Ingresa el endpoint. Pega https://api.deepseekapikey.com/v1 en el campo de endpoint personalizado. SillyTavern añade la ruta de finalización de chat por sí misma, así que déjala fuera. Si obtienes un 404 más tarde, intenta la ruta completa como segundo intento.
6. Ingresa la clave. Pega la clave en el campo de clave de API personalizada.
7. Ingresa el modelo. Escribe uncensored en el campo de ID del modelo. Si un menú desplegable de modelos se carga desde el endpoint GET /v1/models, puedes elegirlo desde allí.
8. Conecta. Presiona Conectar. Un estado verde y el nombre del modelo significan que la llamada tuvo éxito. Envía un mensaje a un personaje para confirmar.

Si Conectar falla, prueba fuera de SillyTavern en una terminal. Esto aísla el problema:

Copycurl https://api.deepseekapikey.com/v1/chat/completions \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "uncensored", "messages": [{"role": "user", "content": "Reply with the word ready."}], "max_tokens": 10}'

Una respuesta JSON normal significa que la clave y la URL son válidas y el problema está en los campos de SillyTavern. La guía de inicio rápido lista más ejemplos.

Tamaño del contexto y longitud de respuesta

Aquí es donde las configuraciones de roleplay funcionan bien o desperdician dinero. El modelo tiene una ventana de contexto de 100.000 tokens, contando el prompt y la respuesta juntos. SillyTavern tiene su propio control deslizante de Tamaño de contexto en la configuración de muestreo, que controla cuánto del historial y los datos del personaje empaqueta en cada petición.

Puedes configurarlo hasta 100.000, pero piensa en lo que eso significa. SillyTavern construye el prompt completo en cada turno: prompt del sistema, tarjeta de personaje, entradas del libro de lore, persona, y luego tanto historial de chat como quepa. Una configuración mayor significa que el modelo ve más del pasado, y pagas por cada uno de esos tokens nuevamente en cada mensaje.

Una forma práctica de elegir:

• 8.000 a 16.000 tokens: escenas cortas y chats rápidos. Barato y rápido.
• 30.000 a 50.000 tokens: una historia larga con una tarjeta de personaje detallada y libro de lore. Bueno para la mayoría de usuarios.
• Hasta 100.000 tokens: libros de lore grandes o historias continuas muy largas. Deja un margen para que el prompt más la respuesta se mantengan bajo la ventana.

Para la longitud de respuesta, establece Longitud Máxima de Respuesta en 300 a 600 tokens para una respuesta de roleplay típica. El parámetro max tokens es opcional en la API, pero SillyTavern envía un valor, y un límite detiene una respuesta demasiado larga de aumentar la factura. Activa la opción de streaming para que el texto aparezca a medida que se genera; la API admite eventos enviados por el servidor con stream: true.

Pasar los valores de penalización y muestreo funciona como sugiere la interfaz. Se envían al modelo la temperatura, top_p, penalización por frecuencia y penalización por presencia, y también se pasan las secuencias de parada y una semilla fija. Empieza con una temperatura de alrededor de 0.8 y ajusta: más baja si el personaje pierde el hilo de los hechos, más alta si las respuestas se sienten repetitivas.

Costo del roleplay

El precio es $0,15 por 1M de tokens de entrada y $0,50 por 1M de tokens de salida. La entrada domina debido al historial reenviado. Ejemplos trabajados, con una respuesta de 400 tokens cada vez:

Verifica una fila: 20.000 / 1.000.000 x $0,15 = $0,003, y 400 / 1.000.000 x $0,50 = $0,0002, lo que da $0,0032. Con ese tamaño, el crédito de prueba de $0,50 cubre aproximadamente 156 mensajes. Las peticiones fallidas o rechazadas no se cobran, por lo que los reintentos tras un error no suman a la factura. Los swipes y las regeneraciones sí cuentan, porque cada uno es una nueva petición completada.

El crédito es prepago, no caduca y no hay suscripción. Recarga cualquier cantidad entera desde $20 hasta $500, con +5% desde $50, +10% desde $100 y +15% desde $200. Por ejemplo, $100 se convierten en $110. Puedes pagar con cripto (USDT en TRC20, USDC en Base). La página de precios tiene la lista actual.

Chats grupales, swipes y límites de peticiones

SillyTavern puede enviar varias peticiones cerca entre sí: chats grupales donde varios personajes responden en secuencia, swipes y extensiones que resumen o generan contenido lateral. Una clave completa permite 8 peticiones concurrentes y 300 peticiones por minuto. Una clave de prueba permite 2 concurrentes y 60 por minuto.

Si ves un error con el código concurrency, es porque había demasiadas peticiones simultáneas. Espera a que termine el streaming actual antes de volver a enviar, porque una petición en streaming mantiene su espacio hasta que finaliza. Un error con el código rate_limited indica que excediste el límite por minuto. Un 429 con el encabezado Retry-After: 5 es una sobrecarga temporal que se resuelve rápido.

Para historias largas, considera usar la extensión de resumen o entradas del libro de lore para mantener los hechos, así puedes mantener el tamaño del contexto más bajo. Un resumen corto de los eventos anteriores al inicio del prompt cuesta mucho menos que mantener cincuenta mil tokens de historial sin procesar.

Solución de problemas comunes

La conexión dice no autorizado

La clave es incorrecta, tiene un espacio al final o proviene de otro servicio. Una clave emitida por la plataforma de DeepSeek no funciona con esta URL base.

La conexión dice no encontrado

Verifica la ortografía del endpoint. Debería terminar en /v1 en la configuración común. Algunas versiones esperan la ruta completa de finalización de chat, así que si la forma corta falla, prueba con https://api.deepseekapikey.com/v1/chat/completions.

Las respuestas son cortas o se cortan

Aumenta la longitud máxima de respuesta. Si el corte ocurre solo en chats largos, tu prompt puede estar cerca del límite de la ventana; reduce un poco el tamaño del contexto para dejar espacio para la respuesta.

El personaje olvida eventos anteriores

Eso es el ajuste de contexto en acción. Auméntalo o mueve los hechos clave a la tarjeta del personaje, la persona o una entrada del libro de lore para que se mantengan en cada prompt.

La respuesta es rechazada

El modelo está ajustado para evitar rechazos de contenido para uso adulto legal, pero una regla no cambia: no hay contenido sexual que involucre a menores de edad. Los personajes y escenarios en esa área son rechazados. El servicio es solo de texto, por lo que la generación de imágenes en SillyTavern necesita un backend diferente.

Los prompts enviados a través de la API no se usan para entrenamiento. Tus archivos de chat permanecen en la carpeta de datos de SillyTavern en tu máquina a menos que los muevas. Si quieres el contexto sobre cómo este servicio difiere del propio de DeepSeek, consulta DeepSeek API: mitos vs. hechos.

Más guías

• Clave de API de DeepSeek en Janitor AI: configuración con nuestra API
• Clave de API de DeepSeek en VS Code: configuración con nuestra API
• API de DeepSeek: mitos vs. realidades para acceso sin censura