Saltar para o conteúdo

HyperFrames: editar vídeo com IA sem perder a identidade da marca

Consultor GEO & AIOPublicado a
Película de filme enrolada em espiral

Neste artigo

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.md em minúsculas. Se não existir, o agente procura design.md e depois DESIGN.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.md em maiúsculas. O ficheiro pode ser ignorado.
  • Animações baseadas em temporizadores (setInterval e 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.md e 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.md por 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.

Quer aplicar isto na sua empresa? Falamos 30 minutos.