O problema da maioria das ferramentas de vídeo com IA não é a qualidade. É a consistência. Cada vídeo sai com uma legenda diferente, uma cor ligeiramente ao lado, um tipo de letra que ninguém escolheu. Ao fim de um mês, o feed da marca parece feito por cinco agências.
O HyperFrames, um projeto de código aberto da HeyGen, ataca esse problema de forma diferente: o vídeo é escrito como uma página web, e as regras visuais da marca ficam num ficheiro que o agente de IA lê antes de cada vídeo. Neste guia explico o que é, quanto custa, como se instala e como o usar num fluxo de marketing real.
Termos usados neste artigo
- HyperFrames: framework de código aberto da HeyGen que transforma ficheiros HTML com indicações de tempo em vídeos MP4.
- Claude Code: a versão do Claude que trabalha em ficheiros e pastas do seu computador, através do terminal ou da app de desktop.
- Skill: ficheiro de instruções que ensina um agente de IA a executar uma tarefa com um método definido (por exemplo, legendar um vídeo).
- Renderizar: o processo de transformar o projeto num ficheiro de vídeo final.
- FFmpeg: ferramenta gratuita, padrão da indústria, para converter, cortar e montar ficheiros de áudio e vídeo.
- Design system: conjunto documentado das regras visuais de uma marca (cores, tipos de letra, espaçamentos, componentes).
O que é o HyperFrames
Num editor tradicional, trabalha numa linha do tempo. No HyperFrames não há linha do tempo: o vídeo é um ficheiro HTML com atributos que dizem quando cada elemento entra e sai. Um navegador Chrome sem janela captura o resultado fotograma a fotograma, e o FFmpeg monta o MP4.
Na prática, quem escreve esse HTML é o agente de IA (Claude Code, Codex, Cursor, Gemini CLI, entre outros). O seu papel passa a ser descrever o que quer, aprovar pré-visualizações e pedir correções por escrito.
Alguns factos verificados em outubro de 2026:
- Licença Apache 2.0, sem taxas por renderização nem limites de uso comercial.
- Mais de 68 mil estrelas no GitHub e desenvolvimento muito ativo (versões 0.x, ou seja, ainda em evolução rápida).
- Requisitos: Node.js 22 ou superior e FFmpeg.
- Renderização local e gratuita, com opções pagas na nuvem (HeyGen ou AWS Lambda) que não são obrigatórias.
O custo real está no modelo de IA que usa para dirigir o trabalho: se tem uma subscrição Claude, o consumo sai do limite do plano; se usa a API, paga por tokens.
O ficheiro que faz a diferença: frame.md
O frame.md é um ficheiro na raiz do projeto com a identidade visual dos vídeos da marca: cores em código hexadecimal, tipos de letra, formato (por exemplo 9:16 para Reels), margens de segurança, regras de legenda e componentes como o cartão de nome e cargo ou o cartão de estatística.
O agente lê-o antes de cada vídeo e segue duas regras:
- Valores fixos são copiados à letra: cores e tipos de letra não mudam.
- A composição é livre: onde entra um cartão e como anima pode variar de vídeo para vídeo.
Notas práticas:
- O nome deve ser
frame.mdem minúsculas. Se não existir, o agente procuradesign.mde depoisDESIGN.md. - No site do projeto (hyperframes.dev/design) há estilos prontos que pode copiar e adaptar com as cores da sua marca.
- Se já tem um manual de normas gráficas, este é o momento de o converter num ficheiro que a IA consegue ler. Esse trabalho só se faz uma vez.
Pedido para gerar o ficheiro (adapte os valores):
Cria o frame.md deste projeto a partir do manual de normas da marca (ficheiro manual-marca.pdf nesta pasta).
Formato: 9:16, 1080x1920.
Cores e tipos de letra: usa exatamente os do manual, sem inventar valores.
Inclui em components: legenda, cartão de nome e cargo e cartão de estatística.
Antes de concluir, mostra-me três fotogramas de exemplo para aprovação.
Instalação
1. Pré-requisitos
node -v # tem de ser 22 ou superior
brew install ffmpeg # macOS
winget install ffmpeg # Windows
2. Instalar as skills no Claude Code
Como plugin:
claude plugin marketplace add heygen-com/hyperframes
claude plugin install hyperframes@hyperframes
Ou como skills isoladas:
npx skills add heygen-com/hyperframes
3. Verificar o ambiente
npx hyperframes doctor
O comando confirma Node.js, FFmpeg e navegador. Se algo falhar aqui, falha também na renderização.
4. Criar o primeiro projeto
npx hyperframes init video-01
Coloque dentro da pasta o vídeo em bruto e o frame.md, abra o Claude Code na pasta e comece com /hyperframes.
Sem terminal? A HeyGen disponibiliza também um conector HyperFrames para clientes de chat como o claude.ai, que cria e renderiza projetos na sua conta HeyGen, sem instalar nada localmente. É mais simples, mas o projeto fica alojado na HeyGen e não em ficheiros seus.
As skills mais úteis para marketing
O projeto inclui mais de vinte skills. Para equipas de marketing, estas são as que mais rendem:
| Skill | Para que serve |
|---|---|
/hyperframes |
Ponto de entrada: percebe o pedido e escolhe o fluxo certo |
/embedded-captions |
Legendas sobre vídeos de pessoa a falar, com palavras-chave em destaque |
/talking-head-recut |
Cartões gráficos sincronizados com a fala (nome, dado, citação) |
/motion-graphics |
Peças curtas sem narração: texto animado, número a subir, logótipo |
/product-launch-video |
Vídeo promocional de 30 a 90 segundos a partir de um URL ou briefing |
/faceless-explainer |
Vídeo explicativo sem rosto, a partir de texto |
/media-use |
Música, efeitos, imagens e voz, com registo da origem de cada ficheiro |
Três fluxos práticos
1. Legendar um vídeo gravado com telemóvel
/embedded-captions
Legenda o vídeo bruto.mp4 com a identidade definida no frame.md.
Antes de compor, mostra-me a transcrição para eu corrigir nomes e termos técnicos.
Destaca no máximo uma palavra-chave por ideia.
Mostra-me três momentos em pré-visualização e só renderiza depois da minha aprovação.
A transcrição é feita localmente com o Whisper, sem chave de API. Para português, use um modelo de transcrição maior (por exemplo large-v3-turbo): os modelos pequenos erram mais palavras.
2. Acrescentar cartões a um vídeo de opinião ou entrevista
/talking-head-recut
Propõe um storyboard com no máximo cinco cartões para este vídeo.
Usa apenas números e afirmações que são ditos no vídeo. Não acrescentes dados.
Corre o check antes de renderizar.
3. Criar uma peça curta de abertura
/motion-graphics
Cria uma abertura de 6 segundos com o logótipo e a frase "[mensagem da campanha]".
Consulta primeiro o catálogo de blocos disponíveis antes de animar de raiz.
Rever e renderizar
Antes de entregar, use sempre a sequência:
npx hyperframes check
npx hyperframes preview --background
npx hyperframes render --quality draft
npx hyperframes render --quality high --output final.mp4
O rascunho serve para validar ritmo e textos. A versão final só se gera quando tudo está aprovado, porque é a mais demorada.
Erros comuns
- Node.js abaixo da versão 22. A instalação funciona, mas a renderização falha.
FRAME.mdem maiúsculas. O ficheiro pode ser ignorado.- Animações baseadas em temporizadores (
setIntervale afins). Partem a renderização fotograma a fotograma; o agente deve usar animações controláveis no tempo (GSAP pausado, CSS keyframes). - Destacar todas as palavras da legenda. Se tudo está em destaque, nada está.
- Renderizar sem
check. Erros que demoram segundos a corrigir no projeto custam minutos de renderização. - Música sem origem conhecida. Use apenas faixas com licença e registe a origem; uma reclamação de direitos de autor pode silenciar ou remover o vídeo.
O que esperar de verdade
- O primeiro vídeo leva uma tarde, entre instalação,
frame.mde ajustes. Os seguintes demoram minutos. - Não é “um prompt e está feito”. O processo tem pontos de aprovação: transcrição, pré-visualização e rascunho.
- Não substitui o critério editorial. O agente aplica regras; decidir o que merece destaque continua a ser trabalho de marketing.
- A ferramenta é grátis, o trabalho não. Para agências e freelancers, o valor está em configurar o padrão da marca e entregar com consistência.
Para quem faz sentido
- Marcas com produção regular de vídeo curto que querem consistência visual sem depender de um editor para cada peça.
- Agências que gerem várias marcas: um
frame.mdpor cliente garante que nada se mistura. - Equipas que já usam o Claude Code para outras tarefas e querem acrescentar vídeo ao mesmo fluxo.
Se a equipa não tem ninguém confortável com o terminal, comece pelo conector no claude.ai ou por ferramentas de edição visual, e volte ao HyperFrames quando o volume justificar.
Quer montar um sistema de produção de vídeo para a sua marca? Marque uma análise rápida ao seu negócio em jorgerosendo.com e vemos juntos marketing, vendas, tecnologia e IA.
Informação verificada em outubro de 2026 no repositório oficial do HyperFrames. O projeto está em evolução rápida: em caso de dúvida, consulte npx hyperframes --help.
Artigo publicado em jorgerosendo.com — IA, Marketing, SEO e Produtividade.