SpicyGen

npx add-mcp 'https://www.spicygen.ai/api/mcp'

SpicyGen para agentes de IA

Un servidor MCP y una API REST permiten que Claude Code, Cursor, Codex, Claude Desktop y cualquier agente que hable Streamable HTTP o HTTP plano trabajen con una cuenta de SpicyGen: crear personajes, generar imágenes y videos, construir películas, gestionar la biblioteca y obtener un enlace de pago. Los mismos controles de moderación, créditos, suspensión y verificación de edad que se aplican en el sitio web se aplican a cada llamada.

1. Crear una clave de API

Inicia sesión en https://www.spicygen.ai/login (o regístrate en https://www.spicygen.ai/signup y confirma tu correo electrónico), abre https://www.spicygen.ai/account#api-keys, y crea una clave. Las claves tienen el formato sg_live_…, se muestran una sola vez y se pueden revocar en cualquier momento. Marca Sandbox para obtener una clave sg_sandbox_… que responde a cada herramienta con datos de prueba y no gasta nada.

2. Conectar

Claude Code:

claude mcp add --transport http spicygen https://www.spicygen.ai/api/mcp --header "Authorization: Bearer sg_live_…"

Cursor (~/.cursor/mcp.json o .cursor/mcp.json):

{ "mcpServers": { "spicygen": { "url": "https://www.spicygen.ai/api/mcp", "headers": { "Authorization": "Bearer sg_live_…" } } } }

Codex (~/.codex/config.toml):

[mcp_servers.spicygen]
url = "https://www.spicygen.ai/api/mcp"
http_headers = { Authorization = "Bearer sg_live_…" }

Claude Desktop y otros clientes solo-stdio se conectan a través de mcp-remote:

{ "mcpServers": { "spicygen": { "command": "npx", "args": ["-y", "mcp-remote", "https://www.spicygen.ai/api/mcp", "--header", "Authorization: Bearer sg_live_…"] } } }

REST en lugar de MCP: POST https://www.spicygen.ai/api/v1/tools/{tool_name} con el mismo encabezado y un cuerpo JSON de argumentos. GET https://www.spicygen.ai/api/v1/tools lista las herramientas con sus esquemas. OpenAPI 3.1: https://www.spicygen.ai/openapi.json.

3. Pide algo a tu agente

"Crea un personaje llamado Mara, una mujer de unos treinta años con cabello oscuro y rizado y pecas, y luego genera cuatro imágenes fotorrealistas de ella en una playa." El agente llama a read_content_rules, create_character, espera a que get_character indique que está listo, y luego generate_images y get_job.

Reglas que la superficie aplica

• Cada indicación pasa por la misma moderación que el sitio web (ver https://www.spicygen.ai/ai-policy). Una indicación bloqueada no cuesta nada, pero cuenta como una falta.
• Las herramientas que gastan créditos (create_character, generate_images, generate_video, create_movie_scene) y delete_item devuelven approval_required con el costo en créditos primero. El agente lo muestra, el usuario dice que sí, el agente llama de nuevo con el token (caduca en 15 minutos, vinculado a los argumentos exactos). Las cuentas pueden omitir las aprobaciones desde la tarjeta de claves de API; nada más cambia.
• Verificación de edad: donde la ley lo exige, las URL de medios NSFW se retienen hasta que el usuario complete la verificación única; get_account informa el estado y la URL de verificación.
• Límite de velocidad: 60 solicitudes por minuto por clave. Diez claves activas por cuenta.
• El pago siempre es una URL de pago alojada que el humano abre; el agente nunca maneja datos de tarjeta.

Habilidades

Archivos SKILL.md que contienen el flujo de trabajo completo para un trabajo (llamadas a herramientas en orden, costos, la regla de aprobación): https://www.spicygen.ai/skills/index.json. Instala en .claude/skills/<name>/SKILL.md o apunta tu sistema a la URL sin procesar. Fuente: https://github.com/Wayfinity/spicygen-skills.

Referencia de herramientas

Cuenta y reglas

• get_account: Empieza aquí. Saldo de créditos, estado de verificación de edad para la jurisdicción del solicitante (si los medios NSFW están disponibles y la URL de verificación cuando no lo están), costos de créditos por imagen, por segundo de video y por personaje, límites de velocidad y si la cuenta omite aprobaciones.
• read_content_rules: Las reglas de uso aceptable contra las que se verifican cada indicación e imagen (solo adultos, solo personajes ficticios, sin personas reales, sin menores, sin falta de consentimiento, sin violencia). Lee esto antes de escribir indicaciones; una indicación bloqueada no cuesta nada, pero cuenta para las faltas de moderación de la cuenta.
• get_credit_packs: Paquetes de créditos y precios disponibles para esta cuenta (paquetes regionales cuando correspondan), con lo que cada paquete compra en imágenes y segundos de video.
• get_checkout_link: Una URL de pago alojada para un paquete de créditos. Entrega la URL al usuario; él paga en su navegador (tarjeta, métodos locales o cripto según la región). Nunca pidas ni ingreses datos de tarjeta. Los créditos se acreditan en la cuenta cuando el proveedor confirma; get_account muestra el nuevo saldo.
• get_referral_stats: El código de referencia y enlace del usuario, registros referidos, clics y créditos ganados. Los pagos del programa de afiliados (Tapfiliate) se leen en el panel de afiliados, no aquí.

Personajes

• list_characters: Los personajes guardados del usuario (id, nombre, apariencia, estilo, estado, miniatura). Usa un id de personaje en generate_images, generate_video y create_movie_scene para una identidad consistente.
• get_character: Un personaje con sus generaciones recientes (imágenes y videos). Las URL de medios NSFW se retienen cuando la jurisdicción de la cuenta exige verificación de edad que el usuario no ha completado.
• create_character (protegida): Crear un personaje reutilizable a partir de una descripción de texto (10 créditos). Genera la imagen de identidad; consulta get_character hasta que el estado sea ready (aproximadamente un minuto). La descripción pasa por la misma moderación de indicaciones que el sitio web.

Generación

• generate_images (protegida): Genera de 1 a 10 imágenes a partir de una indicación (5 créditos cada una Estándar, 10 HD; una referencia de personaje fuerza HD). Devuelve ids de trabajo; consulta get_job. Las indicaciones se moderan exactamente como en el sitio web; llama a read_content_rules primero.
• generate_video (protegida): Convierte una imagen de la biblioteca (source_item_id) o un personaje (character_id) en un video con una indicación de movimiento. Cuesta de 10 a 20 créditos por segundo según calidad y modelo (ver get_account.costs). Devuelve un id de trabajo; consulta get_job (los videos tardan unos minutos).
• create_movie_scene (protegida): Agrega una escena a una película y comienza a generarla en SpicyMotion v3.0 Fast (HD, audio). Omite movie_id para iniciar una nueva película; la primera escena necesita un source_item_id o character_id, las escenas posteriores continúan desde el último fotograma de la escena anterior. Cuesta 20 créditos por segundo. Consulta get_job con el id de trabajo devuelto; cuando se complete, llama a create_movie_scene nuevamente para la siguiente escena y luego combine_movie.
• combine_movie (protegida): Une las escenas completadas de una película en un solo video (sin créditos, pero se renderiza en el servidor y está protegida para que el usuario confirme el corte). Devuelve la URL de la película.
• get_job: Estado de un trabajo de generación (en cola, generando, completado, fallido), progreso y, al completarse, las URL de imagen o video (retenidas con nsfw_withheld:true cuando aplica el control de edad). Consulta cada 10 a 20 segundos.

Biblioteca

• list_library: Las imágenes y videos generados del usuario, más recientes primero, con indicación, estado, marcador de favorito y URL (NSFW retenido cuando aplica el control de edad). Pagina con cursor.
• favorite_item: Marca o desmarca un elemento de la biblioteca como favorito.
• delete_item (protegida): Elimina una imagen o video de la biblioteca. Irreversible; protegida para que el usuario confirme.

Costos

• Personaje: 10 créditos (una imagen de identidad, reutilizable en cada generación posterior).
• Imagen: 5 créditos Estándar, 10 créditos HD (una referencia de personaje siempre es HD).
• Video, SpicyMotion v3.0: 10 créditos por segundo Estándar, 15 HD, de 3 a 15 segundos.
• Video, SpicyMotion v3.0 Fast (audio nativo, hasta 30 segundos): 15 créditos por segundo Estándar, 20 HD. Las escenas de películas usan este modelo en HD.