# Workflow n8n > Conecte a WayinVideo API ao n8n para criar workflows de vídeo com IA auto-hospedados para clipping, resumos, transcrição, Find Moments e processamento agendado. ## 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](https://wayin.ai/pt/api-docs/upload/) 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](https://wayin.ai/pt/api-docs/ai-clipping/) 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](https://wayin.ai/pt/api-docs/ai-clipping/) 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 ```bash 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](https://wayin.ai/pt/api-docs/upload/) para arquivos privados e a [Find Moments API](https://wayin.ai/pt/api-docs/find-moments/) 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](https://wayin.ai/pt/api-docs/upload/) 2. Envie o arquivo local para a URL pré-assinada 3. Passe a `identity` retornada como `video_url` para a [Find Moments API](https://wayin.ai/pt/api-docs/find-moments/) 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 ```bash 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](https://wayin.ai/pt/api-docs/ai-clipping/), [Find Moments API](https://wayin.ai/pt/api-docs/find-moments/), [Video Summarization API](https://wayin.ai/pt/api-docs/video-summarization/) ou [Video Transcription API](https://wayin.ai/pt/api-docs/video-transcription/) 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 ```bash 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 | Objetivo do Workflow | API | |----------------------|-----| | Transformar vídeos longos em clipes curtos | [AI Clipping API](https://wayin.ai/pt/api-docs/ai-clipping/) | | Encontrar momentos específicos com uma consulta em linguagem natural | [Find Moments API](https://wayin.ai/pt/api-docs/find-moments/) | | Gerar uma visão geral estruturada do vídeo e destaques de linha do tempo | [Video Summarization API](https://wayin.ai/pt/api-docs/video-summarization/) | | Extrair transcrições com tempos e labels de falantes | [Video Transcription API](https://wayin.ai/pt/api-docs/video-transcription/) | | Enviar arquivos locais de vídeo ou áudio antes do processamento | [Upload API](https://wayin.ai/pt/api-docs/upload/) | | Renderizar ou reexportar clipes selecionados | [Clips Export API](https://wayin.ai/pt/api-docs/clips-export/) | --- ## 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](https://wayin.ai/pt/api-docs/ai-clipping/) 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](https://wayin.ai/pt/api-docs/upload/) 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.