Geração de IA Assíncrona Utilizando um Ciclo de Sondagem (Polling) do Replicate - Fluxo de trabalho n8n

Desenvolvedores e Integradores de IA: Utilizadores que necessitam de incorporar modelos de IA de longa duração e assíncronos (como os alojados no Replicate) nos seus processos de negócio standard.
Utilizadores Avançados do n8n: Indivíduos que procuram exemplos avançados de utilização do nó Code do n8n e estruturas de controlo de fluxo (If e Wait) para lidar com APIs externas.
Especialistas em Automação de Conteúdo: Qualquer pessoa que procure modelos n8n fiáveis para gerar conteúdo criativo com base em instruções (prompts).
Automatizadores Técnicos: Utilizadores que necessitam de um mecanismo de acionamento (trigger) robusto no n8n para iniciar tarefas de computação complexas.

A geração de conteúdo complexo requer frequentemente a execução de tarefas de forma assíncrona, o que significa que o pedido inicial devolve imediatamente um estado, mas o resultado final é atrasado. Este fluxo de trabalho robusto do n8n resolve isto ao implementar uma sequência de sondagem (polling) personalizada e não bloqueadora, concebida especificamente para a API do Replicate.

À semelhança de integrações mais simples, este modelo n8n garante fiabilidade ao iniciar a previsão, extrair o ID da tarefa e, em seguida, verificar continuamente o estado a cada dois segundos até que a tarefa seja concluída com sucesso. A utilização do nó httpRequest do n8n, combinada com a manipulação de dados no nó Code do n8n, fornece uma estrutura poderosa e reutilizável para integrar qualquer serviço assíncrono no seu ambiente n8n. Esta estrutura é essencial para construir automações de missão crítica utilizando o n8n.

Este poderoso fluxo de trabalho n8n começa com um acionador manual do n8n:

1. Inicialização: O fluxo de trabalho é executado manualmente através do acionador 'On clicking 'execute'' (Ao clicar em 'executar') do n8n. Imediatamente a seguir, o nó 'Set API Key' do n8n injeta de forma segura a sua chave API do Replicate como uma variável para os pedidos HTTP subsequentes.


2. Iniciar Previsão: O nó 'Create Prediction' (Criar Previsão) do n8n (um Pedido HTTP) envia um pedido POST para o Replicate, especificando a versão do modelo e a instrução (prompt) de entrada necessária. Isto dá início à tarefa de IA assíncrona.


3. Extração: A resposta do pedido de criação contém o ID da tarefa. O nó Code do n8n 'Extract Prediction ID' (Extrair ID da Previsão) analisa esta resposta, armazenando o ID da previsão e o URL necessário para a sondagem.


4. Entrada no Ciclo de Sondagem: A execução entra no ciclo de sondagem. Primeiro atinge o nó 'Wait' (Aguardar) do n8n, pausando todo o fluxo de trabalho n8n durante 2 segundos para evitar pedidos de API excessivos.


5. Verificação de Estado: O nó httpRequest 'Check Prediction Status' (Verificar Estado da Previsão) consulta então o URL de previsão extraído anteriormente para obter o estado atual da tarefa de IA.


6. Verificação Condicional: O nó If (Se) do n8n 'Check If Complete' (Verificar Se Concluído) avalia o estado. Se o estado for 'succeeded' (bem-sucedido) (ramo Verdadeiro), a tarefa está concluída, e o fluxo de trabalho n8n avança para processar o resultado. Se o estado for qualquer outro (ramo Falso), a ligação regressa ao nó 'Wait' do n8n, reiniciando o processo de sondagem até à conclusão.


7. Processamento do Resultado: Uma vez bem-sucedido, o nó Code do n8n 'Process Result' (Processar Resultado) extrai o conteúdo final gerado (muitas vezes um URL para o ativo) e formata-o de forma organizada para utilização posterior no seu fluxo de trabalho n8n.

Para utilizar este modelo de fluxo de trabalho n8n, siga estes passos:

1. Importar: Copie o código JSON fornecido e importe-o diretamente para a sua instância n8n.


2. Configuração da Chave API (Replicate): Localize o nó 'Set API Key' do n8n.

1. Configurar a Entrada do Modelo: Localize o nó 'Create Prediction' do n8n. Na sua configuração de Corpo JSON, modifique o valor prompt e quaisquer outros parâmetros de entrada (como width, height, etc.) para corresponder aos seus requisitos de geração desejados. Certifique-se de que a versão do modelo no corpo JSON está correta.


2. Execução: Execute o fluxo de trabalho n8n manualmente utilizando o botão 'Execute Workflow' (Executar Fluxo de Trabalho) no nó acionador 'On clicking 'execute'' para testar a integração e o ciclo de sondagem.

On clicking 'execute' (Acionador Manual): Serve como o acionador inicial do n8n para todo o fluxo de trabalho n8n, permitindo a execução manual para testes e configuração.
Set API Key (Set): Um nó crítico do n8n utilizado para definir de forma segura a chave API do Replicate, tornando-a acessível como uma expressão ($($Set API Key).item.json.replicateapikey) no resto do fluxo de trabalho n8n.
Create Prediction (HTTP Request): Envia o pedido POST assíncrono inicial para a API do Replicate, iniciando a tarefa de geração de IA. Inclui cabeçalhos personalizados para autorização utilizando a chave API definida anteriormente.
Extract Prediction ID (Code): Um nó Code personalizado do n8n crucial para ler a resposta do pedido de previsão inicial. Extrai o predictionId único e constrói o URL de sondagem necessário para os pedidos subsequentes no fluxo de trabalho n8n.
Wait (Wait): Gere o controlo de fluxo ao pausar o fluxo de trabalho n8n durante um período definido (2 segundos), evitando pedidos de API rápidos durante o ciclo de sondagem.
Check Prediction Status (HTTP Request): Executa um pedido GET utilizando o URL de previsão extraído para verificar o estado da tarefa de IA em execução. Este é o passo de sondagem central neste modelo n8n.
Check If Complete (If): Um nó de controlo de fluxo do n8n que direciona a lógica do fluxo de trabalho n8n. Se o estado for 'succeeded', avança para o gestor de resultados; caso contrário, regressa ao nó 'Wait' para continuar a sondagem.
Process Result (Code): O nó Code final que executa apenas em caso de sucesso. Estrutura e extrai a saída finalizada, incluindo métricas e o URL do ativo gerado, limpando os dados para os próximos passos no seu fluxo de trabalho n8n mais vasto.