Nodaro com o n8n

O n8n pode iniciar qualquer workflow do Nodaro com uma única requisição HTTP e receber a imagem, o vídeo ou o áudio pronto em um nó Webhook do n8n. O Nodaro faz a geração. O n8n decide quando a execução acontece e para onde o resultado vai depois. Nenhuma das duas direções precisa de uma chave de API do Nodaro, porque o próprio endereço de webhook do workflow inicia a execução.

Como os dois se conectam

1. Um nó HTTP Request do n8n envia por POST um corpo JSON, por exemplo um prompt, ao endereço de webhook de um workflow do Nodaro.
2. O workflow do Nodaro começa com um Gatilho de webhook, executa os nós dele e termina com uma Saída de webhook.
3. A Saída de webhook envia o resultado por POST a um nó Webhook do n8n, e o restante do seu workflow do n8n continua a partir dali.

Etapa 1: receber o resultado no n8n

Crie primeiro o lado que recebe, porque o workflow do Nodaro precisa do endereço dele.

1. No n8n, adicione um nó Webhook.
2. Defina HTTP Method como POST e dê ao nó um Path, por exemplo nodaro-result.
3. Mantenha Respond em Immediately, para que o n8n responda ao Nodaro na hora.
4. Copie a Production URL.

O n8n registra a Production URL quando você publica o workflow do n8n. A Test URL escuta por apenas 120 segundos depois que você seleciona Listen for test event; por isso, use-a só enquanto monta o workflow.

Etapa 2: montar o workflow do Nodaro

1. Adicione um nó Gatilho de webhook. Em Parâmetros de saída, adicione um parâmetro chamado prompt, do tipo Texto.
2. Conecte a saída prompt à entrada de prompt de um nó Gerar imagem, ou de qualquer outro nó que crie um resultado.
3. Adicione um nó Saída de webhook. Cole a Production URL do n8n em URL do webhook. Em Parâmetros de entrada, adicione image_url, do tipo URL de imagem, e conecte a imagem a ele.
4. Salve o workflow. Selecione o Gatilho de webhook e copie o endereço dele em URL do webhook.

O endereço tem a forma https://app.nodaro.ai/v1/webhooks/<token>. O token funciona como uma senha: qualquer pessoa que tenha o endereço pode iniciar o workflow.

Etapa 3: iniciar a execução pelo n8n

1. No n8n, adicione um nó HTTP Request no ponto em que a execução deve começar.
2. Defina Method como POST e cole o endereço do Nodaro em URL.
3. Ative Send Body, defina Body Content Type como JSON e escolha Using JSON em Specify Body.
4. Digite o corpo. As chaves são os nomes dos seus parâmetros de saída:

{ "prompt": "{{ $json.prompt }}" }

Um jeito mais rápido: selecione Import cURL no nó HTTP Request e cole este comando com o seu token:

curl -X POST "https://app.nodaro.ai/v1/webhooks/<token>" \
  -H "Content-Type: application/json" \
  -d '{"prompt": "A red kite over a green hill, morning light"}'

O que volta

O Nodaro responde ao nó HTTP Request na hora, antes de gerar qualquer coisa. A resposta é 202, com o ID da execução:

{ "executionId": "3f9e2b1a-7c6d-4e5f-8a9b-0c1d2e3f4a5b", "status": "pending" }

Quando a execução termina, a Saída de webhook envia o resultado por POST ao seu nó Webhook do n8n. O corpo tem uma chave por parâmetro de entrada, e os valores de mídia são endereços de arquivos no Nodaro:

{ "image_url": "https://cdn.nodaro.ai/images/2538b658-d2e1-42ee-890a-72ce06089feb.png" }

No n8n, o corpo recebido fica em body; por isso, o nó seguinte lê o endereço como {{ $json.body.image_url }}.

Consultar periodicamente em vez de usar um webhook

Quando o n8n não consegue receber uma requisição vinda da internet, consulte o resultado periodicamente com um token de API pessoal. A consulta periódica funciona para workflows dos seus projetos pessoais.

1. Mantenha o nó HTTP Request da etapa 3. Ele retorna o executionId.
2. Adicione um nó Wait com Resume definido como After Time Interval, por exemplo 10 segundos.
3. Adicione um nó HTTP Request com Method GET e a URL https://app.nodaro.ai/v1/api/status/{{ $json.executionId }}. Envie o cabeçalho Authorization com o valor Bearer <your API token>, salvo como credencial do n8n.
4. Adicione um nó If. Enquanto status for pending ou running, conecte o ramo dele de volta ao nó Wait.
5. Quando o status for completed, chame https://app.nodaro.ai/v1/api/result/<executionId> do mesmo jeito. A resposta lista as saídas da execução com os endereços delas.

Executar um workflow com novos valores de entrada descreve as respostas de status e de resultado.

Limites a considerar

Quanto custa

O Gatilho de webhook e a Saída de webhook não custam nada. Você paga os créditos dos nós entre eles, pelos mesmos preços do editor. No exemplo acima, cada execução custa o preço de uma imagem do Nano Banana 2, 22 créditos. Os créditos reservados para um nó que falha voltam automaticamente.

O mesmo padrão funciona no Make e no Zapier. Automações trata dos agendamentos e das outras formas de iniciar um workflow.