n8n

n8n es una herramienta de automatización de flujos de trabajo. SpicyAPI le ofrece modelos de imagen, video, audio y chat detrás de una sola API y un solo saldo prepago. Hay tres formas de conectarlos, y se pueden combinar en un mismo flujo de trabajo:

Las tres usan la misma cuenta, la misma clave, los mismos modelos y los mismos precios. Para generar contenido multimedia, el nodo y las plantillas de HTTP Request comprueban el precio antes de enviar la solicitud. Reenviar la misma solicitud multimedia aceptada con su Idempotency-Key original devuelve la tarea existente.

Para empezar con imágenes, consulta la guía de flujos de imágenes NSFW con n8n: selección de modelos, edición con una referencia, un primer retrato y ejemplos de coste. Los pasos siguientes permiten conectarlo a tu instancia de n8n.

Antes de empezar

• Una clave de API. Crea una en la consola; empieza por sk-spicy-. Consulta Configura tu cuenta si aún no tienes cuenta.
• Saldo. Añade fondos en Billing de la consola antes de tu primera generación. Los flujos de n8n, Studio y la API comparten el saldo de tu cuenta. Consulta Facturación para conocer la liquidación de los cargos.
• Una clave por automatización. Los flujos de trabajo pueden ejecutarse con mucha más frecuencia que los clics de una persona. Crea una clave exclusiva para n8n y ponle un límite de gasto diario o mensual, para que un error en un bucle tenga un techo. Consulta Autenticación.
• n8n puede acceder a api.spicyapi.ai. Las llamadas las hace el servidor de n8n, no tu navegador.

Opción 1: el nodo de la comunidad de SpicyAPI

El nodo es de código abierto (MIT) en github.com/spicyapi-ai/n8n-nodes-spicyapi y está publicado en npm como @spicyapi/n8n-nodes-spicyapi. No tiene dependencias en tiempo de ejecución y solo se comunica con api.spicyapi.ai.

Otros paquetes de npm tienen nombres parecidos pero pertenecen a servicios sin relación. Este es el paquete llamado @spicyapi/n8n-nodes-spicyapi, y su credencial se llama SpicyAPI (spicyapi.ai) API.

Instalación

cd ~/.n8n/nodes
npm install @spicyapi/n8n-nodes-spicyapi

Operaciones

Genera imágenes, video y audio

Las tres operaciones Generate comparten los mismos campos:

1. Model. Elige de la lista, que muestra los modelos del recurso seleccionado con su precio inicial, o introduce un ID de modelo a mano. Todos los modelos y sus parámetros están en spicyapi.ai/models.
2. Prompt. La entrada de texto principal del modelo. En los modelos de voz es el texto que se va a pronunciar. Déjalo vacío para los modelos que no tienen prompt, como los de ampliación.
3. Media Inputs. Imágenes, videos o audio que lee el modelo. Elige el campo (la lista muestra las entradas de archivo del modelo seleccionado) y luego usa un campo binario del nodo anterior o una URL. Los archivos binarios se suben a SpicyAPI automáticamente. Añade varias entradas para el mismo campo para rellenar campos de lista, como las imágenes de referencia.
4. Model Parameters. Un formulario generado a partir del esquema del modelo seleccionado: relación de aspecto, resolución, duración, seed, etc. Los campos que dejes vacíos no se envían, así que el modelo usa su valor por defecto.
5. Additional Parameters (JSON). Cualquier otro campo de entrada como objeto JSON. Tienen prioridad sobre los campos anteriores.

La salida contiene el registro de la tarea (taskId, state, cost, settled, output). Con Download Output activado, que es el valor por defecto, los archivos también se adjuntan como datos binarios en data, data_1, etc. Los enlaces de output.assets[].url caducan al cabo de unos 20 minutos; las copias binarias no.

Los videos grandes se mantienen en memoria a menos que n8n guarde los datos binarios en disco. En n8n autoalojado, establece N8N_DEFAULT_BINARY_DATA_MODE=filesystem cuando trabajes con video.

Control de costos y reintentos

• Cada elemento se cotiza primero. El nodo pide una cotización. Si la cotización supera Max Cost per Item (USD), que por defecto es $2, se detiene con un error antes de crear nada, y no se cobra nada. Establece el límite en 0 para quitarlo.
• La tarea se crea con el precio cotizado. Si el precio cambia entre la cotización y el envío, el nodo cotiza de nuevo, comprueba el límite otra vez y reenvía.
• Los reintentos no cobran dos veces. Consulta Límites de costo y reintentos.

Tareas de larga duración

Consulta Tareas de video de larga duración para ver las opciones y cuándo usar cada una.

Opción 2: plantillas de HTTP Request

Dos flujos de trabajo importables usan solo nodos integrados de n8n, así que funcionan en n8n autoalojado y en n8n Cloud, sin nodo de la comunidad. Están en la carpeta de ejemplos del repositorio del nodo.

Cómo está construida la plantilla de imagen

Los mismos pasos sirven para cualquier modelo multimedia, así que puedes copiar el patrón en tu propio flujo de trabajo.

Las estructuras de solicitud y respuesta están en Tareas, Cotizaciones y compatibilidad y Entradas y salidas multimedia. Los archivos que lee un modelo, como una imagen inicial, pueden ser una URL pública o un archivo spicy:// subido.

Opción 3: modelos de chat en AI Agent y otros nodos de IA

El endpoint de chat de SpicyAPI es compatible con OpenAI, así que los propios nodos de OpenAI de n8n pueden usarlo. No necesitas el nodo de la comunidad para esto, y funciona en n8n Cloud.

https://api.spicyapi.ai/v1

Cosas que conviene saber:

• La lista de modelos incluye modelos de imagen y video. Con una Base URL personalizada, n8n muestra todo lo que devuelve /v1/models, y la lista de SpicyAPI abarca todos sus modelos. Elige uno que termine en /chat, o escribe el ID en modo expresión. Los modelos de imagen y video no son modelos de chat y fallarán en un agente.
• Use Responses API. Las versiones recientes del nodo OpenAI Chat Model pueden enviar solicitudes a /v1/responses en lugar de /v1/chat/completions. SpicyAPI admite /v1/responses, pero no previous_response_id. Si una solicitud del agente falla con Responses API activado, desactiva Use Responses API en el nodo.
• Ajustes de muestreo. Si estableces una opción que el modelo no declara, como temperature en un modelo de razonamiento, SpicyAPI la ignora en lugar de fallar y enumera los nombres ignorados en el encabezado de respuesta X-Spicy-Ignored-Params; un valor fuera del rango del modelo se cambia por el valor aceptado más cercano y se enumera en X-Spicy-Adjusted-Params. Los demás campos no declarados siguen devolviendo 400.
• Las herramientas y la salida JSON dependen del modelo. Consulta los supported_parameters del modelo en /v1/models.
• Los modelos de razonamiento cuentan los tokens de razonamiento dentro de max_tokens. Con un valor muy pequeño, como 20, un modelo de razonamiento puede gastar todo el presupuesto pensando y no devolver texto (upstream_failed: "the output budget was spent on reasoning"). Aumenta max_tokens o reduce reasoning_effort. Los valores de reasoning_effort difieren según el modelo.
• Streaming y costo. El chat se factura por tokens después de la llamada. La página Texto y streaming tiene los detalles, y Recetas de chat incluye ejemplos de solicitudes.

Límites de costo y reintentos

Límites de gasto

• Usa una clave exclusiva para n8n con un límite de gasto diario o mensual en la consola, y una lista de modelos permitidos si el flujo de trabajo solo necesita unos pocos modelos. Cuando se alcanza un límite, la llamada falla con 40202 y no se cobra nada por ella.
• Para los modelos multimedia, cotiza primero. El nodo lo hace por ti; las plantillas lo hacen con los nodos Get Quote e If. La cotización es el precio exacto de esa solicitud, incluidos extras como los cargos por imagen de referencia, así que una comprobación de precio basada en una cotización es fiable y una basada en la tabla del catálogo no lo es.
• Los fallos normales y las tareas caducadas liberan toda la retención. Algunos rechazos de contenido solo se cobran cuando la página del modelo lo indica expresamente. Lee settled y cost para conocer el cargo final; consulta Facturación.

Por qué un reintento no cobra dos veces

Cada llamada que crea una tarea lleva un Idempotency-Key. Si la misma clave llega de nuevo con la misma solicitud, SpicyAPI devuelve la tarea que ya creó en lugar de crear una segunda, de modo que no se produce una segunda retención ni un segundo cobro. Esto importa en n8n porque una solicitud puede enviarse dos veces sin que hagas nada: Retry On Fail en un nodo, o un tiempo de espera agotado en el que la primera solicitud sí se procesó.

• El nodo de la comunidad construye la clave a partir de la ejecución, el nodo, el elemento y su entrada. Un reintento del nodo reutiliza la misma clave. Una ejecución nueva, una entrada modificada u otra pasada por un bucle es trabajo nuevo y recibe una clave nueva.
• Las plantillas la construyen a partir del ID de ejecución y el índice del elemento, por ejemplo n8n-<execution id>-<item index>. Si copias el patrón en un bucle, añade el contador del bucle a la clave, o cada pasada devolverá la tarea de la primera.
• No uses un valor aleatorio que cambie en cada intento, como $now: hace que cada reintento parezca trabajo nuevo.

Más información en Idempotencia.

Tareas de video de larga duración

Los modelos de imagen y audio suelen terminar dentro de una sola solicitud. El video puede tardar minutos. Tienes tres formas de gestionarlo, de la más sencilla a la más ligera para n8n:

Si el nodo deja de esperar, la tarea sigue ejecutándose en SpicyAPI y se cobra si tiene éxito. Recógela más tarde con Task > Get; no la envíes de nuevo. También puedes encontrarla en Logs en la consola.

Los resultados se conservan durante un tiempo limitado y los enlaces de descarga duran unos 20 minutos. Guarda los archivos en el flujo de trabajo, por ejemplo en almacenamiento en la nube, si los necesitas durante más tiempo. Consulta Retención.

Solución de problemas

Los errores de SpicyAPI terminan con un request_id o un ID de tarea. Indícalo al soporte y la solicitud se podrá localizar con exactitud. Los códigos de error se explican en Errores, y hay una lista de comprobación más amplia en Solución de problemas.

El uso de los modelos está sujeto a los términos de SpicyAPI y a los términos de la edición de n8n que uses.