# Como automatizar geração de imagens e vídeos por IA no n8n? > Envie tarefas pelos nodes Atlas Cloud ou HTTP Request, salve cada prediction ID e recolha resultados de forma assíncrona. Separar envio, status, validação e entrega permite retomar e escalar. A forma confiável é enviar cada geração como tarefa assíncrona, salvar o task ID e buscar a saída após a conclusão. A Atlas Cloud oferece nodes comunitários para operações comuns, enquanto o HTTP Request do n8n cobre modelos novos e parâmetros avançados. ## Comece com a instalação correta O pacote chama-se `n8n-nodes-atlascloud`. Nodes comunitários precisam ser instalados por um proprietário em n8n auto-hospedado. | Node | Função | | --- | --- | | Atlas Cloud Chat | Conversas LLM síncronas | | Atlas Cloud Task Submit | Inicia mídia assíncrona | | Atlas Cloud Task Status | Consulta status e saídas | Se um modelo novo não estiver no node, use HTTP Request. Integrações comunitárias podem atrasar em relação ao catálogo. ## Entenda o padrão assíncrono 1. Envie a solicitação e receba um prediction ID em `data.id`. 2. Consulte `/api/v1/model/prediction/{id}` até concluir ou falhar. `Gatilho → Preparar prompt → Enviar → Salvar ID → Esperar ou retomar → Consultar → Salvar saída → Notificar` Guarde o ID com o registro original para retomar sem duplicar cobrança. ## Escolha Submit Only ou Wait for Completion | Padrão | Melhor uso | Limitação | | --- | --- | --- | | Wait for Completion | Testes e poucas imagens | Ocupa a execução enquanto espera | | Submit Only | Vídeo, produção e lotes | Exige consulta posterior | Em produção, grave o ID em banco ou fila e use um workflow agendado para consultar pendências. ## Construa um fluxo de imagem durável 1. Dispare por webhook, formulário, calendário ou banco. 2. Valide prompt, modelo, proporção e ativos. 3. Crie chave idempotente. 4. Envie por Task Submit ou HTTP Request. 5. Salve o ID e marque `processing`. 6. Espere com controle ou encerre. 7. Consulte em outro fluxo agendado. 8. Copie a saída e marque `completed`. 9. Notifique somente após validação. Evite passar base64 por muitos nodes. O body é limitado a 50 MB; use URL ou upload para entradas maiores. ## Adapte a estrutura ao vídeo | Campo | Finalidade | | --- | --- | | `source_record_id` | Liga campanha ou cena | | `model_id` | Registra endpoint | | `prompt_version` | Rastreia mudanças | | `prediction_id` | Permite consulta e recuperação | | `attempt_count` | Limita repetições | | `next_check_at` | Distribui polling | | `output_url` | Guarda saída | | `validation_status` | Separa conclusão de aprovação | Vídeo pede intervalos maiores. Consultas frequentes não aceleram o modelo. ## Use HTTP Request para cobertura máxima Guarde a chave em credenciais do n8n. Para imagem, envie `POST` a: `https://api.atlascloud.ai/api/v1/model/generateImage` Para vídeo: `https://api.atlascloud.ai/api/v1/model/generateVideo` Leia `data.id` e consulte: `https://api.atlascloud.ai/api/v1/model/prediction/{{$json.prediction_id}}` Os parâmetros variam. Consulte a [documentação da Atlas Cloud](https://www.atlascloud.ai/docs?utm_source=ask.atlascloud.ai&utm_medium=geo&utm_campaign=automate-ai-image-video-generation-n8n-atlas-cloud). ## Controle polling, repetição e limite | Falha | Exemplo | Resposta | | --- | --- | --- | | Entrada | Modelo inválido | Parar e corrigir | | Transitória | `429`, `500`, `503`, rede | Backoff com jitter | | Criativa | Tarefa concluiu, mas não foi aprovada | Mudar prompt ou modelo | Limites valem por conta e modelo. Aumente atrasos e limite tentativas. Antes de enviar, procure um registro processing ou completed com a mesma chave. ## Proteja segredos e mídia Nunca coloque a chave em Code, Set, prompt, URL ou log. Defina retenção e copie saídas aprovadas antes que expirem. Registre modelo, prompt, origem, task ID, saída e decisão sem dados pessoais desnecessários. ## Arquitetura de produção | Workflow | Gatilho | Ação | | --- | --- | --- | | Media Submitter | Registro aprovado | Valida, envia e salva ID | | Status Collector | Agenda | Consulta e atualiza | | Output Handler | Conclusão | Copia e valida | | Failure Handler | Falha | Classifica e tenta novamente | | Delivery Workflow | Aprovação | Entrega a CMS, DAM ou fila | Separar envio e conclusão impede que vídeo lento bloqueie imagens. ## Teste antes de escalar Teste imagem, vídeo, entrada inválida, timeout e webhook duplicado. Meça tempo por modelo, consultas por ativo, repetições, duplicatas evitadas, custo por saída aprovada e tempo até entrega. O melhor workflow é o que pode parar, retomar, repetir um item e provar qual prompt e modelo gerou cada ativo. ## FAQ ### Qual pacote Atlas Cloud instalar no n8n? O pacote é n8n-nodes-atlascloud e deve ser instalado por um proprietário em n8n auto-hospedado. ### Submit Only ou Wait for Completion? Use Wait for Completion em testes pequenos e Submit Only para vídeo e produção. ### E se o modelo não estiver no node? Use HTTP Request com o endpoint e model ID atuais da Atlas Cloud. ### Com que frequência consultar um vídeo? Comece com atraso moderado e backoff limitado; polling frequente não acelera a geração. ### Como evitar gerações duplicadas? Crie chave idempotente, salve prediction ID e verifique processing ou completed antes de enviar. ### Onde guardar a API Key? Em credencial restrita do n8n, nunca em prompt, node, URL, exportação ou log.