n8n
Llama a los modelos LLM, de imagen y de video de Atlas Cloud desde flujos de trabajo de n8n usando los nodos comunitarios.
Los nodos comunitarios de Atlas Cloud llevan el chat con LLM y la generación asíncrona de medios a n8n, de modo que puedes conectar llamadas a modelos dentro de tus automatizaciones junto a tus otras integraciones.
Paquete npm: n8n-nodes-atlascloud
Instalación
En n8n, ve a Settings → Community Nodes → Install.
Introduce el nombre del paquete:
n8n-nodes-atlascloudConfirma la instalación y recarga n8n. Los nodos de Atlas Cloud aparecen en el panel de nodos.
Los nodos comunitarios solo se pueden instalar en instancias de n8n autoalojadas y requieren el permiso del propietario de la instancia.
Añadir credenciales
Crea una clave de API en console/api-keys.
En n8n, crea una nueva credencial del tipo Atlas Cloud API.
Pega la clave y guarda. Todos los nodos de Atlas Cloud de tus flujos de trabajo ya pueden referenciar esta credencial.
Los nodos
Atlas Cloud Chat
Llama al endpoint de chat compatible con OpenAI.
| Campo | Propósito |
|---|---|
| System Prompt | Define el comportamiento del modelo |
| User Prompt | La petición |
| Temperature | Aleatoriedad del muestreo |
| Max Tokens | Límite de longitud de la salida |
| Extra Messages | Turnos de conversación adicionales para contexto de varios pasos |
Atlas Cloud Task Submit
Envía una tarea de generación de imagen o video. El nodo descubre las categorías y los modelos disponibles y luego construye el formulario de parámetros a partir del esquema del modelo seleccionado — así obtienes los campos correctos para ese modelo concreto en lugar de un formulario genérico.
Dos modos:
| Modo | Comportamiento |
|---|---|
| Submit Only | Devuelve el ID de la predicción de inmediato. Combínalo con Task Status más adelante |
| Wait for Completion | Bloquea hasta que la tarea termina y devuelve el resultado |
Para los modelos de video, prefiere Submit Only. La generación puede tardar minutos, y mantener abierta una ejecución de n8n tanto tiempo es frágil — un diseño de encolar y consultar sobrevive mucho mejor a reinicios y tiempos de espera.
Atlas Cloud Task Status
Consulta una tarea por su ID de predicción. Intervalo de consulta, tiempo de espera y número de reintentos configurables.
Un flujo de trabajo asíncrono típico: Task Submit (Submit Only) → guardar el ID → Wait → Task Status → ramificar según el resultado.
Flujos de trabajo de ejemplo
El repositorio incluye grafos importables en workflows/:
| Archivo | Patrón |
|---|---|
01-chatbot.json | Respondedor de chat con LLM |
02-text-to-image.json | Generación de imagen síncrona |
03-async-video.json | Enviar, consultar y gestionar el video terminado |
Notas
- Los nodos se mantienen en el repositorio de código abierto en lugar de distribuirse con n8n, así que van por detrás de los modelos más recientes con cierto margen. Si el modelo que necesitas no está en el selector, llama al nodo HTTP Request contra la API directamente.
- La generación se factura igual que cualquier otra llamada a la API. Consulta Cómo se facturan los modelos.
- Para tareas de video largas, los webhooks son más fiables que la consulta periódica — apunta el webhook a un nodo trigger Webhook de n8n.
Relacionado
Last updated on