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.
Posso usar a fonte da minha marca nas legendas?
Sim, se a sua ferramenta de legendas aceitar envio de fontes e a licença da fonte cobrir vídeo. No CaptionBolt, adicione um arquivo TTF estático de até 15 MB na página Minhas fontes, ou importe uma fonte do Google Fonts, e escolha-a na fonte ao personalizar Legendas, Título ou Capa. Funciona em todos os planos, aparece no MP4 exportado e pode ser salva numa predefinição de vídeo.
Em quais idiomas o CaptionBolt legenda, e ele traduz?
O CaptionBolt legenda o idioma falado no seu vídeo. Deixe o idioma falado em Detectar automaticamente ou escolha entre 47 idiomas, como inglês, espanhol, português, francês, alemão, chinês, cantonês, japonês, hindi e árabe. As legendas ficam no idioma falado: o CaptionBolt não traduz legendas nem dubla o áudio, então uma versão traduzida precisa de uma etapa de tradução à parte.
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.