n8n
Richiama i modelli LLM, immagine e video di Atlas Cloud dai workflow n8n usando i nodi della community.
I nodi della community di Atlas Cloud portano la chat LLM e la generazione di media asincrona dentro n8n, così puoi collegare le chiamate ai modelli alle tue automazioni insieme alle altre integrazioni.
Pacchetto npm: n8n-nodes-atlascloud
Installazione
In n8n, vai su Settings → Community Nodes → Install.
Inserisci il nome del pacchetto:
n8n-nodes-atlascloudConferma l'installazione e aggiorna n8n. I nodi di Atlas Cloud compaiono nel pannello dei nodi.
I nodi della community si possono installare solo su istanze n8n self-hosted e richiedono il permesso del proprietario dell'istanza.
Aggiungere le credenziali
Crea una chiave API su console/api-keys.
In n8n, crea una nuova credenziale di tipo Atlas Cloud API.
Incolla la chiave e salva. Ora ogni nodo Atlas Cloud nei tuoi workflow può fare riferimento a questa credenziale.
I nodi
Atlas Cloud Chat
Richiama l'endpoint di chat compatibile con OpenAI.
| Campo | Scopo |
|---|---|
| System Prompt | Imposta il comportamento del modello |
| User Prompt | La richiesta |
| Temperature | Casualità del campionamento |
| Max Tokens | Limite di lunghezza dell'output |
| Extra Messages | Turni di conversazione aggiuntivi per un contesto multi-passaggio |
Atlas Cloud Task Submit
Invia un'attività di generazione di immagini o video. Il nodo individua le categorie e i modelli disponibili, poi genera il modulo dei parametri dallo schema del modello selezionato — così ottieni i campi giusti per quel modello specifico invece di un modulo generico.
Due modalità:
| Modalità | Comportamento |
|---|---|
| Submit Only | Restituisce subito l'ID di predizione. Da abbinare più tardi a Task Status |
| Wait for Completion | Si blocca finché l'attività non termina e poi restituisce il risultato |
Per i modelli video, preferisci Submit Only. La generazione può richiedere minuti e tenere aperta un'esecuzione n8n così a lungo è fragile — un'architettura basata su coda e polling regge molto meglio riavvii e timeout.
Atlas Cloud Task Status
Controlla un'attività tramite l'ID di predizione. Intervallo di polling, timeout e numero di tentativi sono configurabili.
Un tipico workflow asincrono: Task Submit (Submit Only) → salva l'ID → Wait → Task Status → ramifica in base al risultato.
Workflow di esempio
Il repository include grafi importabili sotto workflows/:
| File | Schema |
|---|---|
01-chatbot.json | Risponditore chat LLM |
02-text-to-image.json | Generazione di immagini sincrona |
03-async-video.json | Invia, interroga e gestisci il video completato |
Note
- I nodi sono mantenuti nel repository open source anziché essere distribuiti con n8n, quindi restano indietro di un po' rispetto ai modelli più recenti. Se un modello che ti serve manca dal selettore, richiama direttamente l'API con il nodo HTTP Request.
- La generazione viene fatturata come qualsiasi altra chiamata API. Vedi Fatturazione dei modelli.
- Per le attività video di lunga durata, i webhook sono più affidabili del polling — punta il webhook a un nodo trigger Webhook di n8n.
Argomenti correlati
Last updated on