Workflow n8n

Integração de Workflow de Vídeo n8n

Use o n8n para criar workflows WayinVideo amigáveis para desenvolvedores com requisições HTTP, transformações JavaScript personalizadas, jobs agendados, webhooks, bancos de dados e infraestrutura auto-hospedada.

O n8n é uma boa opção quando você quer mais controle sobre credenciais, comportamento de retry, armazenamento, código personalizado e workflows de processamento de vídeo em grande escala.

Com a WayinVideo API e o n8n, você pode criar automação de vídeo auto-hospedada para pipelines de YouTube para clipes, processamento de arquivos privados, operações de conteúdo agendadas, polling com banco de dados e integrações personalizadas com CMS.

A WayinVideo não exige um nó dedicado do n8n. Você pode se conectar pelo nó HTTP Request usando sua API key da WayinVideo.

O Que Você Pode Automatizar com n8n

• Workflows de YouTube para clipes: monitore feeds RSS ou registros de canais e gere clipes curtos com títulos, descrições, hashtags, pontuações e links de exportação.
• Processamento de vídeo privado: envie arquivos locais com a Upload API e execute clipping, resumo, transcrição ou busca de momentos.
• Polling agendado: use workflows Cron para processar vídeos em fila e verificar tarefas incompletas ao longo do tempo.
• Transformações personalizadas: use nós Function para remodelar resumos, transcrições e metadados de clipes antes de armazená-los.
• Integrações com sistemas internos: envie resultados para bancos de dados, ferramentas CMS, webhooks, Slack, Google Sheets ou apps internos de revisão.

Como Funciona

A maioria dos workflows n8n segue este padrão:

1. Trigger: comece com um nó Cron, nó Webhook, trigger RSS, evento de armazenamento ou consulta de banco de dados.
2. Enviar: use o nó HTTP Request para chamar um endpoint da WayinVideo API.
3. Armazenar: salve o id da tarefa retornado em um banco de dados, planilha ou item do workflow.
4. Consultar: use execuções agendadas ou lógica de loop para chamar o endpoint de resultado até que status seja SUCCEEDED ou FAILED.
5. Transformar: use nós Function para remodelar metadados de clipes, resumos, transcrições ou links de exportação.
6. Entregar: envie resultados para um CMS, banco de dados, Slack, Google Sheets, fila de revisão social ou webhook interno.

Recomendamos consultar o status da tarefa a cada 30 segundos.

Exemplo: Pipeline de YouTube RSS para Clipes Sociais

Este workflow usa a AI Clipping API para transformar novos vídeos do YouTube em saídas de clipes curtos para revisão ou publicação.

Trigger: Feed RSS do YouTube ou verificação agendada de novos vídeos.

Passos:

1. Detecte uma nova URL de vídeo do YouTube
2. Envie para a AI Clipping API com enable_export definido como true
3. Consulte até que status seja SUCCEEDED
4. Use um nó Function para formatar títulos, descrições, hashtags, pontuações e valores de export_link
5. Escreva os resultados no Google Sheets, em um banco de dados ou em uma fila de revisão de mídia social

Ideal para: Ferramentas para criadores, equipes de mídia e sistemas internos de conteúdo que precisam de pipelines repetíveis de vídeo longo para vídeo curto.

Requisição de Envio

curl -X POST https://wayinvideo-api.wayin.ai/api/v2/clips \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "x-wayinvideo-api-version: v2" \
  -H "Content-Type: application/json" \
  -d '{
    "video_url": "https://www.youtube.com/watch?v=example",
    "enable_export": true,
    "resolution": "HD_720",
    "enable_caption": true,
    "enable_ai_reframe": true,
    "ratio": "RATIO_9_16"
  }'

Exemplo: Enviar Arquivos, Encontrar Momentos e Armazenar Resultados

Este workflow usa a Upload API para arquivos privados e a Find Moments API para pesquisar vídeos com uma consulta em linguagem natural.

Trigger: Novo arquivo em armazenamento na nuvem ou formulário interno de upload.

Passos:

1. Solicite uma URL de upload pela Upload API
2. Envie o arquivo local para a URL pré-assinada
3. Passe a identity retornada como video_url para a Find Moments API
4. Consulte até que os resultados estejam prontos
5. Armazene momentos correspondentes, timestamps, títulos, descrições e hashtags no seu CMS ou banco de dados

Ideal para: Equipes que gerenciam arquivos de vídeo privados em vez de URLs públicas de vídeo.

Requisição Find Moments

curl -X POST https://wayinvideo-api.wayin.ai/api/v2/clips/find-moments \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "x-wayinvideo-api-version: v2" \
  -H "Content-Type: application/json" \
  -d '{
    "video_url": "file_abc123",
    "query": "product demo moments",
    "enable_export": false
  }'

Exemplo: Jobs Agendados de Inteligência de Vídeo

Este workflow pode usar a AI Clipping API, Find Moments API, Video Summarization API ou Video Transcription API conforme o tipo de tarefa na fila.

Trigger: Agendamento Cron.

Passos:

1. Leia registros de vídeo pendentes de um banco de dados ou planilha
2. Envie cada registro para o endpoint correto da WayinVideo
3. Armazene IDs e status das tarefas
4. Consulte tarefas incompletas na próxima execução agendada
5. Notifique sua equipe quando resumos, transcrições ou clipes estiverem prontos

Ideal para: Equipes de engenharia que querem automação confiável e retomável sem executar um serviço worker personalizado.

Verificação de Resultado

curl -X GET https://wayinvideo-api.wayin.ai/api/v2/clips/results/proj_abc123 \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "x-wayinvideo-api-version: v2"

APIs Recomendadas

Boas Práticas

• Armazene sua API key em credenciais do n8n ou variáveis de ambiente protegidas.
• Mantenha IDs de tarefas em armazenamento persistente se o polling ocorrer entre várias execuções do workflow.
• Use nós Function para normalizar resultados antes de gravá-los em um CMS, banco de dados ou planilha.
• Adicione caminhos de retry e falha para respostas FAILED e timeouts de requisição.
• Para filas grandes, use polling baseado em Cron em vez de manter uma única execução aberta por muito tempo.
• Se o workflow precisar de acesso de longo prazo aos clipes, copie os arquivos de export_link para seu próprio armazenamento após a exportação.

FAQ

A WayinVideo tem um nó nativo do n8n?

Você pode conectar a WayinVideo API ao n8n pelo nó HTTP Request. Um nó dedicado do n8n não é necessário.

O n8n pode automatizar o clipping de vídeos do YouTube?

Sim. Use um trigger RSS, agendado, de banco de dados ou webhook para detectar uma URL do YouTube, envie para a AI Clipping API e armazene os clipes e links de exportação retornados.

O n8n pode processar arquivos de vídeo privados?

Sim. Primeiro envie o arquivo pela Upload API e depois passe a identity retornada como video_url para AI Clipping, Find Moments, Video Summarization ou Video Transcription.

Qual é a melhor forma de consultar tarefas da WayinVideo no n8n?

Para workflows pequenos, você pode consultar dentro da mesma execução. Para filas maiores, use polling baseado em Cron e armazenamento persistente de tarefas para que os workflows continuem retomáveis e confiáveis.