Automação e agentes de AI
Existe uma API de legendas com webhooks que eu possa usar com n8n ou Zapier?
Resposta curta
Sim. Um serviço de legendas com API REST e webhooks se encaixa no n8n ou no Zapier pelas etapas genéricas de requisição HTTP e webhook: uma etapa envia o vídeo e cria um projeto legendado, e um webhook avisa o seu fluxo quando a exportação está pronta. A Public API e os webhooks do CaptionBolt funcionam assim no plano Max; não existe um app dedicado para n8n ou Zapier.
4 min de leitura
Como é um fluxo automático de legendas?
A maioria das automações de legenda segue o mesmo formato:
- Gatilho: um vídeo novo chega a uma pasta, um formulário ou uma ferramenta de projetos.
- Enviar e criar: o fluxo envia o arquivo ao serviço de legendas e cria um projeto com um estilo ou uma predefinição salva.
- Esperar um webhook: o serviço chama o seu fluxo quando a exportação termina, em vez de o fluxo ficar perguntando o tempo todo.
- Buscar o resultado: o fluxo pede um link de download do MP4 legendado ou dos arquivos de legenda.
- Entregar: salve o arquivo, mande para aprovação ou passe para a sua ferramenta de publicação.
O que uma API de legendas precisa oferecer?
- Envio de arquivos a partir do fluxo, nos formatos em que você grava.
- Escolha de estilo ou predefinição, para que todos os vídeos tenham o mesmo visual.
- Exportação automática, para ninguém precisar abrir um editor nos vídeos de rotina.
- Webhooks com assinatura, para o fluxo confiar no aviso.
- Novas tentativas e histórico de entregas que falharam.
- Limites claros: limite de requisições, tamanho de arquivo e como os minutos são contados.
Como conecto uma API de legendas no n8n?
Use o nó HTTP Request com a sua API key no cabeçalho Authorization para enviar o vídeo e criar o projeto. Adicione um nó Webhook para receber os eventos de conclusão e publique-o numa URL HTTPS pública. Verifique a assinatura do webhook antes de agir sobre um evento. Veja a documentação do nó HTTP Request do n8n.
Como conecto uma API de legendas no Zapier?
Use o Webhooks by Zapier: um gatilho Catch Hook recebe os eventos de conclusão e uma ação Custom Request chama a API. Arquivos grandes são mais fáceis de enviar a partir do seu próprio armazenamento ou de uma etapa de código do que de um campo de formulário. Veja o Webhooks by Zapier.
Como fazer com o CaptionBolt
A Public API e os webhooks do CaptionBolt permitem que o n8n, o Zapier ou o seu próprio código legendem vídeos com os mesmos estilos e predefinições do app web, no plano Max.
- Autenticação: API keys com permissões para ler projetos, criar projetos, exportar e gerenciar webhooks. As chaves expiram em 90 dias por padrão.
- Envios: arquivos MP4, MOV, WebM e AVI. Uma URL de vídeo remota não serve como entrada, então baixe o arquivo no seu fluxo antes.
- Projetos: escolha um estilo ou uma predefinição salva e use a exportação automática para terminar sem abrir o editor, ou o modo de revisão para conferir as legendas antes.
- Eventos de webhook:
project.ready,project.completed,project.failedeproject.cancelled. Os eventos são assinados com os cabeçalhos do Standard Webhooks e levam só metadados, não o vídeo nem o texto das legendas. - Entrega: os receptores precisam usar HTTPS e responder em 15 segundos. Entregas que falham são repetidas automaticamente, e o histórico fica guardado por 30 dias.
- Resultados: links de download do MP4 e dos arquivos de legenda do seu plano.
- Limites: REST e MCP compartilham 120 requisições por conta por minuto. O processamento usa os minutos normais do seu plano; não há uma cota separada para a API.
O Max custa US$ 39 por mês e inclui 1000 minutos de processamento. Comece pelo guia da API e depois pelo guia de webhooks. Para uma visão geral, veja um fluxo de vídeo, três formas de entrar.
Quando outro caminho é melhor
- Você quer um app sem código com ações prontas. O CaptionBolt não tem um app dedicado para n8n ou Zapier; você monta as etapas com requisições HTTP e webhooks.
- Você quer que um assistente de IA faça isso por um chat. Use o MCP; veja se o Claude Code consegue legendar um vídeo do seu computador.
- Você precisa editar o texto das legendas pela API. A API cria, exporta e baixa projetos; as mudanças de palavras são feitas no editor do CaptionBolt.
Perguntas relacionadas
O Claude Code consegue colocar legendas em um vídeo que está no meu computador?
Sim, se você conectá-lo a um serviço de legendas por MCP. O Claude Code pode rodar um servidor MCP local que envia o vídeo que você indicar, legenda no estilo que você escolher e salva o MP4 pronto de volta no seu computador. O servidor MCP local do CaptionBolt faz isso com Claude Code, Codex, Claude Desktop, Cursor e VS Code.
Como redimensiono um vídeo para Reels, posts do feed e Stories do Instagram?
Use 9:16 em 1080×1920 para Reels e Stories, que preenchem a tela do celular, e 4:5 em 1080×1350 quando quiser um vídeo que ocupe menos espaço no feed. O Instagram aceita Reels de 1.91:1 a 9:16, e os novos posts de vídeo são compartilhados como reels. Converta um vídeo horizontal com fundo desfocado ou sólido para manter o quadro inteiro, ou corte quando houver uma pessoa centralizada.
Por que o TikTok ou o Instagram cortam meu vídeo ou colocam tarjas pretas?
Porque o formato do vídeo não combina com a tela. TikTok, Reels e Shorts preenchem uma tela vertical 9:16, então um vídeo horizontal ou quadrado aparece com tarjas pretas ou é ampliado e cortado para preenchê-la, e as grades do perfil mostram uma prévia cortada. Resolva antes de enviar: exporte o vídeo em 9:16 escolhendo você mesmo o corte, um fundo desfocado ou um fundo sólido, assim o app não tem nada para mudar.
Como coloco emojis nas minhas legendas?
Digite o emoji no texto da legenda onde você quiser, ou use um estilo de legenda que adiciona emojis automaticamente ao lado das palavras correspondentes. Use um a cada poucas legendas para que eles acrescentem sentido, e não ruído. Confira como aparecem: algumas ferramentas desenham emojis numa cor só, e o texto gravado no vídeo precisa de uma fonte que tenha emojis.