Bot de Telegram y Discord

El bot de SpicyAPI es un programa pequeño que ejecutas tú mismo. Se conecta a Telegram (y, si quieres, a Discord) y permite que las personas que autorices generen imágenes, creen videos, conviertan imágenes en videos y chateen con personajes que defines. Todo se paga con tu propio saldo de SpicyAPI, y cada solicitud se cotiza antes de cobrar nada.

El bot es gratuito y de código abierto (MIT) en github.com/spicyapi-ai/spicyapi-bot. Es privado por defecto: solo tú puedes usarlo hasta que autorices a otras personas o grupos.

Qué hace el bot

• Imágenes: /pic a lighthouse at dusk
• Videos: /vid waves rolling onto a beach at sunset
• Animar: toca Animate debajo de cualquier imagen que haya creado el bot, o responde a ella con /animate <cómo debe moverse>.
• Chat con personajes: escribe en un chat privado o usa /talk. Las respuestas llegan en streaming dentro de un único mensaje.
• Protección del gasto: cada solicitud se cotiza primero (las cotizaciones son gratuitas), las caras requieren un toque en Confirm, y se aplican límites diarios por persona y para todo el bot.
• Privado por defecto: nadie más puede usarlo hasta que lo autorices.

El catálogo de SpicyAPI incluye modelos sin censura que no añaden ningún filtro de contenido propio, y el bot funciona con cualquier modelo que elijas. La ley y la política de contenido de SpicyAPI siguen aplicándose a todo lo que generes. Consulta Política.

Comandos

Los nombres no son /image, /video ni /chat a propósito, porque otros bots populares los usan, y así este bot puede convivir con ellos en un grupo. En un grupo de Telegram, responde a uno de los mensajes de chat del bot para seguir hablando con el personaje.

Antes de empezar

• Un equipo o servidor que se mantenga encendido, con Docker instalado. (O una cuenta de Railway, consulta más abajo.)
• Una cuenta de SpicyAPI con saldo. Consulta Configura tu cuenta y Facturación.
• Una cuenta de Telegram, para crear el bot con BotFather.

Despliega con Docker Compose

git clone https://github.com/spicyapi-ai/spicyapi-bot.git
cd spicyapi-bot
cp .env.example .env

SPICY_API_KEY=sk-spicy-...
TELEGRAM_BOT_TOKEN=123456789:AA...
OWNER_ID=your-telegram-user-id

docker compose up -d

docker compose up -d --build
docker compose logs -f

Para actualizar más adelante, ejecuta git pull && docker compose up -d --build.

Despliega en Railway

Railway puede ejecutar el bot sin que tengas un servidor propio. No hay una plantilla de un clic: despliegas desde tu propia copia del repositorio.

Mantén el servicio con una sola réplica: dos copias que consultan el mismo token de Telegram se pelean por las actualizaciones. El bot no necesita dominio público ni puerto abierto.

Añade Discord (opcional)

Discord no permite apps con comandos con restricción de edad en su App Directory, así que mantén el bot privado. .env.example también incluye DISCORD_MEDIA_IN_DMS, que por defecto es false: entonces las imágenes y los videos solo funcionan en canales de servidor con restricción de edad, no en mensajes directos.

Quién puede usarlo

A los desconocidos que encuentren el bot se les dice que es privado y se les da su ID de usuario para que te lo envíen. Los grupos se ignoran hasta que aparecen en ALLOWED_CHAT_IDS; una vez que un grupo está en la lista, todos sus miembros pueden usar el bot, dentro de los límites diarios. Los IDs de grupo de Telegram son negativos, por ejemplo -1001234567890.

Tú operas este bot y eres responsable de a quién dejas usarlo. Se aplican los términos de SpicyAPI, incluidas las regiones en las que SpicyAPI no presta servicio.

Cómo funciona el gasto

1. Primero el precio. SpicyAPI cotiza cada imagen o video antes de que ocurra nada. Las cotizaciones son gratuitas.
2. Techo estricto. Si una solicitud pudiera costar más de MAX_COST_PER_REQUEST_USD (por defecto $1), se rechaza. No se cobra nada.
3. Confirmación. Si pudiera costar más de CONFIRM_ABOVE_USD (por defecto $0.10), el bot muestra el precio con los botones Confirm y Cancel. Solo quien lo pidió puede confirmar.
4. Límites diarios. Cada persona puede gastar USER_DAILY_BUDGET_USD (por defecto $1) por día UTC y todo el bot DAILY_BUDGET_USD (por defecto $5). Las generaciones aún en curso cuentan como gastadas hasta que terminan, de modo que varias solicitudes a la vez no pueden esquivar un límite. A los propietarios solo les afecta el límite de todo el bot.
5. Sin cobros dobles. Cada solicitud lleva una clave de idempotencia derivada del mensaje del chat o del toque en el botón, de modo que una actualización de Telegram duplicada o un doble toque devuelve la tarea que ya existe.
6. Resultados. El progreso se muestra editando un mensaje cada pocos segundos. El resultado muestra el cobro real y el ID de la tarea, que puedes consultar en Logs en la consola.

Una generación aceptada no se puede cancelar. Las ejecuciones correctas se cobran; los fallos normales liberan la retención. Algunos rechazos de contenido solo se cobran cuando la página del modelo lo indica expresamente. Consulta Facturación.

Usa una clave con límite

El bot lleva su propio libro de cuentas en DATA_DIR/state.json. Si ese archivo se pierde, el bot olvida lo gastado hoy. El límite de la clave de API en la consola es el que nunca se puede perder, porque lo aplica SpicyAPI. Crea una clave separada para el bot, establece un límite de gasto diario y, opcionalmente, permite solo los modelos que quieras. Cuando se alcanza el límite, el bot te avisa de que la clave ha llegado a su límite de gasto.

Otros ajustes útiles:

Modelos y precios

Cada persona puede cambiar sus modelos con /models. El operador establece los valores por defecto:

Los ids exactos de los modelos están en .env.example; para cambiarlos, copia otro id del catálogo en vivo (GET /api/v1/models; en el ejemplo de personaje de abajo, MODEL_ID_FROM_CATALOG marca dónde va un id así). Los precios proceden del catálogo público y pueden cambiar; el bot siempre muestra la cotización en vivo. Explora los modelos en spicyapi.ai/models o consulta Modelos. Para roleplay, el ranking de roleplay te ayuda a elegir un modelo de chat.

Personajes

Los personajes viven en un archivo JSON (CHARACTERS_FILE, por defecto characters/default.json, que incluye dos personajes de ejemplo):

{
  "characters": [
    {
      "id": "mira",
      "name": "Mira",
      "system": "You are Mira, ... Never speak or act for {{user}}.",
      "greeting": "Welcome aboard, {{user}}!",
      "model": "MODEL_ID_FROM_CATALOG"
    }
  ]
}

• system son las instrucciones del personaje. greeting (opcional) es su primera frase. model (opcional) fija un modelo de chat para este personaje.
• {{char}} y {{user}} se sustituyen por el nombre del personaje y el nombre de pila de la persona.
• Las entradas también pueden ser JSON de Character Card V2, el formato que exportan la mayoría de los sitios de personajes y SillyTavern. Se usan la descripción, la personalidad, el escenario, el diálogo de ejemplo y el primer mensaje.

Con Docker, monta tu propio archivo y apunta el ajuste hacia él. En docker-compose.yml:

volumes:
  - ./my-characters.json:/app/characters/custom.json:ro

Y en .env:

CHARACTERS_FILE=characters/custom.json

El bot recuerda HISTORY_TURNS intercambios por conversación (por defecto 20) y limita las respuestas a CHAT_MAX_TOKENS tokens (por defecto 2048). Los modelos de razonamiento cuentan su razonamiento dentro de ese límite, así que un valor muy pequeño puede dejar sin espacio a la respuesta. Consulta Recetas de chat para saber más sobre cómo escribir personajes.

Las subidas de fotos están desactivadas por defecto

Por defecto, solo se pueden animar las imágenes que generó el bot. Convertir fotos de personas reales en videos es la principal vía por la que se abusa de bots como este, y una persona que aparece en una foto no ha aceptado aparecer en tu video.

Si estableces ALLOW_PHOTO_UPLOADS=true, cualquiera que autorices puede animar una foto que envíe. Actívalo solo para personas de confianza y solo para fotos de adultos que hayan dado su consentimiento. Cuando está activado, el bot descarga las imágenes subidas y las guarda en SpicyAPI. Los enlaces de archivos de Telegram nunca se transmiten, porque contienen el token de tu bot.

Privacidad: qué se guarda y dónde

Establece RETENTION_SECONDS para pedir a SpicyAPI que elimine los resultados y los prompts antes que el valor por defecto de tu cuenta.

En los grupos, los resultados se ocultan tras un spoiler (SPOILER_MEDIA, por defecto groups; los otros valores son always y never). /report reenvía un mensaje al propietario. El contenido que incumpla las reglas de SpicyAPI también se puede reportar en spicyapi.ai/abuse.

Solución de problemas

Los códigos de error se explican en Errores.