n8n
Chame os modelos de LLM, imagem e vídeo do Atlas Cloud a partir de fluxos de trabalho do n8n usando os nós da comunidade.
Os nós da comunidade do Atlas Cloud trazem chat com LLM e geração assíncrona de mídia para o n8n, para que você possa encaixar chamadas de modelo nas suas automações ao lado das outras integrações.
Pacote npm: n8n-nodes-atlascloud
Instalação
No n8n, vá em Settings → Community Nodes → Install.
Informe o nome do pacote:
n8n-nodes-atlascloudConfirme a instalação e atualize o n8n. Os nós do Atlas Cloud aparecem no painel de nós.
Nós da comunidade só podem ser instalados em instâncias autogerenciadas do n8n e exigem a permissão do proprietário da instância.
Adicionando credenciais
Crie uma chave de API em console/api-keys.
No n8n, crie uma nova credencial do tipo Atlas Cloud API.
Cole a chave e salve. Todos os nós do Atlas Cloud nos seus fluxos de trabalho já podem referenciar essa credencial.
Os nós
Atlas Cloud Chat
Chama o endpoint de chat compatível com OpenAI.
| Campo | Finalidade |
|---|---|
| System Prompt | Define o comportamento do modelo |
| User Prompt | O pedido |
| Temperature | Aleatoriedade da amostragem |
| Max Tokens | Limite de comprimento da saída |
| Extra Messages | Turnos adicionais da conversa para contexto de várias etapas |
Atlas Cloud Task Submit
Envia uma tarefa de geração de imagem ou vídeo. O nó descobre as categorias e os modelos disponíveis e depois monta o formulário de parâmetros a partir do esquema do modelo selecionado — assim você recebe os campos certos para aquele modelo específico, em vez de um formulário genérico.
Dois modos:
| Modo | Comportamento |
|---|---|
| Submit Only | Retorna o ID da predição imediatamente. Combine com o Task Status mais adiante |
| Wait for Completion | Bloqueia até a tarefa terminar e retorna o resultado |
Para modelos de vídeo, prefira Submit Only. A geração pode levar minutos, e manter uma execução do n8n aberta por tanto tempo é frágil — um desenho de enfileirar e consultar sobrevive muito melhor a reinícios e tempos de espera esgotados.
Atlas Cloud Task Status
Verifica uma tarefa pelo ID da predição. Intervalo de consulta, tempo limite e número de tentativas configuráveis.
Um fluxo assíncrono típico: Task Submit (Submit Only) → guardar o ID → Wait → Task Status → ramificar conforme o resultado.
Fluxos de trabalho de exemplo
O repositório inclui grafos importáveis em workflows/:
| Arquivo | Padrão |
|---|---|
01-chatbot.json | Respondedor de chat com LLM |
02-text-to-image.json | Geração síncrona de imagens |
03-async-video.json | Enviar, consultar e tratar o vídeo finalizado |
Observações
- Os nós são mantidos no repositório de código aberto em vez de virem junto com o n8n, então ficam bastante atrás dos modelos mais recentes. Se um modelo de que você precisa não estiver no seletor, chame o nó HTTP Request diretamente contra a API.
- A geração é cobrada da mesma forma que qualquer outra chamada de API. Consulte Como os modelos são cobrados.
- Para tarefas de vídeo demoradas, os webhooks são mais confiáveis do que a consulta periódica — aponte o webhook para um nó de gatilho Webhook do n8n.
Relacionado
Last updated on