Cómo funciona SpicyAPI

Si eres nuevo, empieza aquí. Esta página explica con palabras sencillas qué hace SpicyAPI, te ayuda a elegir la forma de usarlo que mejor te encaja y presenta el puñado de ideas que el resto de la documentación da por sabidas. No necesitas saber programar para leerla.

Qué es SpicyAPI

SpicyAPI te da una sola clave de API para usar modelos de imagen, video y texto de muchos creadores distintos, y cobra por uso en dólares estadounidenses.

Sin él, usar varios modelos de IA significa abrir una cuenta en cada empresa, aprender el formato de solicitud de cada una y recargar saldo en cada una por separado. Con SpicyAPI tienes una cuenta y un saldo. Eliges un modelo, envías tu prompt (y una imagen de referencia, si el modelo la admite) y recibes una imagen, un video o un texto. Cambiar a otro modelo no cambia la forma de enviar una solicitud ni la de recoger el resultado.

• Una clave, muchos modelos. Todos los modelos de imagen y de video se usan igual: envías una tarea y después recoges el resultado. Los modelos de texto aceptan además los formatos de solicitud de las bibliotecas oficiales de OpenAI, Anthropic y Google Gemini.
• Pagas por uso, en dólares. Según el modelo, el precio es por imagen, por segundo de video, por solicitud o por token. No hay suscripción ni un sistema de créditos o puntos: el precio que ves es la cantidad en dólares que se descuenta de tu saldo. Tampoco hay plan gratuito, así que tienes que añadir saldo antes de tu primera generación. Consulta Facturación.
• Cuando se acepta una tarea, su costo estimado queda retenido de tu saldo. Si sale bien, pagas lo que realmente consumió, nunca más de ese importe. Las tareas fallidas o vencidas normalmente liberan toda la retención. Algunos rechazos de contenido se cobran al precio aceptado, solo si la página del modelo indica expresamente esta excepción. Consulta settled y cost para conocer el importe final.
• No hay ningún interruptor de contenido que configurar. SpicyAPI no exige indicar un modo de contenido en la solicitud y no revisa el contenido de cada solicitud. Lo que produzca un modelo depende de ese modelo: algunos rechazan o suavizan ciertas solicitudes. Tú sigues siendo responsable del uso que hagas de lo que generas; consulta Contenido y responsabilidad de uso.

SpicyAPI no presta servicio en China continental, y hay algunas otras regiones restringidas; los detalles están en esa misma página de políticas.

Qué puedes crear

El catálogo incluye también algunas tareas de video más especializadas, como mover a un personaje con el movimiento de otro clip o alargar un clip existente. Los modelos se añaden y se retiran con el tiempo, así que lo que existe hoy lo dice siempre el catálogo en vivo.

Para ver los modelos actuales con imágenes, descripciones y precios, abre spicyapi.ai/explore. La misma lista está disponible sin cuenta ni clave en formato JSON sin procesar, por si quieres consultarla desde una terminal:

curl "https://api.spicyapi.ai/console/v1/catalog/models?locale=en&strict=1"

Verás un bloque de texto largo. Cada modelo tiene un modality (image, video o text), sus tasks y un price inicial. Esa lista pública sirve para curiosear; cuando ya tengas una clave, la lista de modelos que tu clave puede llamar de verdad sale de GET /api/v1/models. Consulta Catálogo en el glosario.

Elige tu camino

Hay cinco formas de empezar. Todas comparten la misma cuenta, el mismo saldo, los mismos modelos y los mismos precios, así que puedes empezar con una y sumar otra más adelante.

Probarlo en el navegador

• Ideal para: cualquiera que quiera ver qué hace un modelo antes de decidir nada. No hay que instalar nada ni escribir código.
• Qué necesitas: un navegador web. Puedes abrir cualquier modelo y rellenar su formulario sin tener cuenta. Para pulsar Ejecutar tienes que iniciar sesión y tener saldo.
• ¿Cuesta dinero? Cada ejecución se cobra igual que una llamada a la API. Las tareas fallidas o vencidas normalmente liberan toda la retención. Algunos rechazos de contenido se cobran al precio aceptado, solo si la página del modelo indica expresamente esta excepción. Consulta settled y cost para conocer el importe final.
• Por dónde empezar: abre spicyapi.ai/explore, elige un modelo y usa la pestaña Playground de su página. Las ejecuciones terminadas aparecen también en Registros, dentro de la consola.

Pedírselo a tu asistente de IA

• Ideal para: quienes ya usan un asistente de IA como Claude, Cursor, VS Code, Codex, Windsurf o Gemini CLI y quieren explorar modelos, comparar precios y generar imágenes o videos conversando. Los desarrolladores también lo usan para explorar antes de programar.
• Qué necesitas: Node.js 22.13 o posterior, una clave de API y una aplicación de asistente compatible con MCP. Los pasos de pago solo funcionan en aplicaciones que pueden mostrarte una pregunta de confirmación.
• ¿Cuesta dinero? Explorar, pedir cotizaciones y consultar resultados es gratis. Iniciar o reintentar una generación se detiene antes y te muestra el precio; el asistente no puede responder esa pregunta por ti.
• Por dónde empezar: el servidor MCP le da al asistente acciones de SpicyAPI. El Agent Skill enseña a un asistente de programación con IA a escribir integraciones con SpicyAPI de forma segura, y combina bien con el servidor MCP.

Escribir comandos en una terminal

• Ideal para: comparar precios, generar imágenes y videos en tu propio equipo y guardar los archivos, repetir el mismo tipo de trabajo o ejecutar un script sencillo. Sin programar.
• Qué necesitas: una terminal, Node.js 22.13 o posterior y una clave de API guardada en la variable de entorno SPICY_API_KEY.
• ¿Cuesta dinero? Solo spicyapi tasks create y spicyapi tasks retry pueden generar cobros, y los dos te preguntan antes de cobrar nada.
• Por dónde empezar: Herramienta de línea de comandos (CLI).

Crear flujos de trabajo con nodos en ComfyUI

• Ideal para: quienes ya trabajan en ComfyUI y quieren usar modelos alojados junto a sus nodos locales: encadenar un modelo de imagen con uno de video, añadir una banda sonora o dejar que un modelo de chat escriba el prompt.
• Qué necesitas: ComfyUI en tu equipo o en un servidor, y una clave de API. Los modelos de SpicyAPI se ejecutan en nuestros servidores, así que para ellos no hace falta GPU.
• ¿Cuesta dinero? Cada ejecución se cobra como una llamada a la API. Cada nodo muestra su tarifa, cotiza antes de ejecutarse y puede detener cualquier ejecución que supere un límite que tú fijes.
• Por dónde empezar: Nodos de ComfyUI.

Escribir código

• Ideal para: añadir generación de imágenes, video o texto a tu propia aplicación, al backend de tu sitio web o a un pipeline de datos.
• Qué necesitas: código que se ejecute en un servidor o en tu propio equipo, porque una clave de API nunca debe ir dentro de una página web ni de una aplicación móvil. Hay SDK oficiales para TypeScript (Node.js 22.13 o posterior), Python 3.11+, Go 1.23+, PHP 8.1+ y Java 17+; desde cualquier otro lenguaje puedes llamar directamente a la API HTTP.
• ¿Cuesta dinero? Se cobra cada generación aceptada. Las cotizaciones, las lecturas del catálogo y las consultas de tareas son gratis.
• Por dónde empezar: el SDK de TypeScript para Node.js, o los SDK de Python, Go, PHP y Java. Para HTTP puro, con ejemplos en curl, Node.js, Python y Go, usa el Inicio rápido; consulta Texto y streaming para modelos de chat y el tutorial de imagen a video para ver un ejemplo completo.

Ideas que vas a encontrar en todas partes

No necesitas nada de esto para probar el Playground, pero todas las demás páginas lo dan por sabido. Cada idea tiene aquí una o dos frases, un enlace a la página que cuenta los detalles y una entrada más extensa, en lenguaje llano, en el glosario.

Qué pasa cuando generas algo

1. Eliges un modelo y rellenas sus entradas.
2. Si quieres, pides una cotización: el precio exacto, gratis.
3. Envías la solicitud. SpicyAPI la acepta como una tarea, te da un ID de tarea y retiene de tu saldo el costo estimado.
4. El modelo trabaja en segundo plano. Las imágenes suelen tardar segundos; los videos, a menudo minutos.
5. La tarea termina. Si salió bien, pagas lo que realmente consumió, nunca más del importe retenido. Las tareas fallidas o vencidas normalmente liberan toda la retención. Algunos rechazos de contenido se cobran al precio aceptado, solo si la página del modelo indica expresamente esta excepción. Consulta settled y cost para conocer el importe final.
6. Recoges el resultado, ya sea porque SpicyAPI llama a tu servidor o porque lo consultas tú, y descargas el archivo. Los enlaces de descarga son temporales y los archivos se guardan durante un tiempo limitado, así que guarda lo que quieras conservar.

ID de modelo

Cada modelo tiene un ID exacto con la forma publisher/model/task. Cópialo del catálogo en vivo (GET /api/v1/models, spicyapi models list o listModels()) y no de memoria ni de una página web: los modelos se añaden, se pausan y se retiran. Los ejemplos de código de esta documentación escriben MODEL_ID_FROM_CATALOG donde va un ID real. Catálogo de modelos y esquemas · Glosario: ID de modelo

Las tareas y sus estados

La generación de imágenes y videos es asíncrona: enviar la solicitud y recoger el resultado son dos pasos separados, unidos por un ID de tarea que empieza por job_. Una tarea pasa de queued a running y termina como succeeded, failed o expired; cualquier estado que no sea queued ni running es definitivo. Los modelos de texto, en cambio, responden por la misma conexión, a menudo palabra por palabra. Tareas asíncronas · Texto y streaming · Glosario: estado de la tarea

Cotización

Una cotización calcula el precio de tu solicitud exacta sin iniciar nada ni retener dinero. Es válida durante cinco minutos. Si envías la solicitud con ella y, mientras tanto, han cambiado el precio o la solicitud, el envío se rechaza en lugar de cobrarse un importe distinto. Cotizaciones y compatibilidad · Glosario: cotización

Clave de idempotencia

Una etiqueta que eliges tú para un trabajo concreto y que envías junto con él. Si se te corta la conexión y vuelves a enviar la misma solicitud con la misma etiqueta y la misma clave de API en menos de 24 horas, recibes la tarea original en lugar de iniciar (y pagar) una segunda. La CLI y el servidor MCP la crean por ti; con el SDK o con HTTP puro la pones tú. Idempotencia · Glosario: clave de idempotencia

Callbacks

En lugar de preguntar una y otra vez si una tarea ha terminado, puedes darle un callBackUrl: una dirección HTTPS pública de tu servidor. Cuando la tarea termina, SpicyAPI envía el resultado a esa dirección, firmado para que puedas comprobar que de verdad viene de SpicyAPI. Preguntar repetidamente, lo que se llama sondeo o polling, está bien mientras haces pruebas en tu propio equipo. Webhooks · Glosario: webhook

Cuánto tiempo se guardan los resultados

El enlace de descarga de un resultado dura unos 20 minutos; vuelve a consultar la tarea para obtener uno nuevo. Los archivos generados se guardan como máximo unos 14 días, los archivos que subes, un día, y el texto del prompt, 30 días; puedes acortar los tres plazos o destruir cuando quieras el contenido de una tarea. Los registros de facturación se guardan mucho más tiempo. Descarga todo lo que quieras conservar. Conservación y destrucción · Glosario: conservación

Saldo y límites de gasto

Tu saldo son dólares estadounidenses prepagados. Además, cada clave de API puede tener un límite de gasto diario, mensual y acumulado que fijas tú. Si tu saldo no cubre una tarea, recibes el error 40201; si se alcanza un límite, recibes 40202. Ninguno de los dos crea una tarea ni cobra nada. Facturación · Autenticación · Glosario: límite de gasto

Tu primera vez, paso a paso

Dónde pedir ayuda

• Respuestas rápidas: Preguntas frecuentes, Glosario, Diagnóstico y recuperación y Errores.
• ¿Funciona el servicio? status.spicyapi.ai.
• Habla con nosotros: abre una conversación en la página de Soporte de la consola o usa la página de contacto. Incluye el request_id o el ID de la tarea y la hora en UTC. Nunca envíes tu clave de API.

Siguientes pasos