# O que é vídeo como código e por que os agentes de IA fazem vídeo assim

> Vídeo como código é escrever o vídeo como uma página web (HTML, CSS e JavaScript) e deixar um motor transformar a página em MP4, quadro por quadro. Agentes de IA já sabem escrever páginas, então conseguem escrever vídeos. O que falta a eles é ver o resultado, e é isso que o Kodecz entrega.

Pedro Henrique Lahr, Konecz, 2026-11-19. https://konecz.com/blog/video-como-codigo-para-agentes

Vídeo como código é escrever o vídeo do mesmo jeito que se escreve uma página de site: texto, cores, posições e movimentos em HTML, CSS e JavaScript. Um motor abre essa página, avança quadro por quadro e grava cada quadro num arquivo MP4. Como os agentes de IA já escrevem páginas web muito bem, esse formato deixa um agente fazer um vídeo inteiro sem abrir um editor de arrastar e soltar.

## Como é um vídeo escrito como código?

É uma pasta com um arquivo `index.html`. No topo da página, um pequeno bloco diz o tamanho do vídeo, quantos quadros por segundo ele tem e quantos quadros dura. O resto é uma página comum.

No Kodecz, o motor de vídeo da Konecz, esse bloco fica assim:

```html
<script type="application/json" id="kodecz">
{ "id": "MeuVideo", "width": 1080, "height": 1920, "fps": 30, "frames": 450 }
</script>
```

Isso quer dizer: vídeo vertical de 1080 por 1920 pixels, 30 quadros por segundo, 450 quadros (15 segundos). Um título que entra no quadro 15 é só uma animação de CSS com atraso de 15 quadros. Vídeo gravado, música e voz entram como `<video>` e `<audio>` dentro da mesma pasta, com o quadro em que começam.

## Por que não usar um editor de vídeo comum?

Porque o editor comum foi feito para olhos e mãos. A pessoa vê a linha do tempo, arrasta um corte, escuta e ajusta. Um agente de IA não tem mãos nem tela. Ele tem arquivos, comandos e texto.

Quando o vídeo é código, tudo o que o agente sabe fazer passa a valer:

1. **Escrever:** o vídeo é texto, e texto é o que o modelo produz melhor.
2. **Mudar uma parte só:** trocar a cor de um título é mudar uma linha, sem refazer o resto.
3. **Repetir sem variar:** a mesma pasta gera o mesmo vídeo. No Kodecz, o quadro *N* depende só da página e de *N*.
4. **Conferir por regra:** dá para medir onde está cada texto em cada quadro, porque o motor sabe.

## Se o agente escreve bem, onde ele erra?

O agente quase nunca erra o código. Ele erra o que só aparece quando duas coisas se encontram na tela. Na análise de 27 defeitos dos nossos próprios vídeos, contada no artigo do Kodecz, 21 eram relações entre duas coisas: texto em cima de um rosto, movimento fora do ritmo da fala, corte no meio de uma palavra. Lendo só o código, nada disso aparece.

Por isso o vídeo como código sozinho não basta. O agente precisa ver o que escreveu. O Kodecz dá isso de três jeitos:

- **Prévia de um quadro** em um a dois segundos, com os mesmos pixels do vídeo final.
- **Conferência automática** de todos os quadros, que responde em JSON com o quadro, o texto e o motivo do problema, mais uma imagem.
- **Blocos de edição** escritos em Markdown, cada um com um exemplo certo e um errado.

O ciclo vira: escrever, olhar, conferir, corrigir e só então gerar o MP4.

## Que tipo de vídeo sai desse jeito?

Qualquer coisa que um navegador desenhe: tipografia animada, gráficos, diagramas, cenas em 3D com WebGL, legenda palavra a palavra, um apresentador gravado com zoom. O que o código não faz bem é imagem fotorrealista. Nesses casos, a imagem vem de outra fonte (filmagem ou IA generativa) e o código cuida do que vai por cima: texto, ritmo, cortes e marca.

No portfólio da Konecz, que tinha 108 vídeos em 19/11/2026, dá para ver os três estilos lado a lado. «Vinho verde não é verde», do perfil Vinhedo Digital, é 2D. «A senha do cofre imperial (Matemática, motion)», das aulas do Fabio Hoinaski, é 3D. «Esse drink americano tem nome em francês», do Ratomix, é realista. Em todos, a montagem final é uma página que vira vídeo.

## Quem precisa entender isso?

Quem desenvolve e quer que o próprio agente faça vídeos: o formato é web comum, sem linguagem nova para aprender. E também o dono de negócio que contrata vídeo feito com IA: quando o vídeo é código, cada erro tem nome e regra, e o fornecedor consegue dizer o que conferiu antes de entregar.

## Perguntas frequentes

**Preciso saber programar para usar vídeo como código?**
Para escrever à mão, sim, o básico de HTML e CSS. Com um agente de IA, você descreve o vídeo e o agente escreve a página.

**Vídeo como código serve para vídeo com pessoa falando?**
Serve. O vídeo gravado entra na página e o código cuida da legenda, do zoom e dos textos ao redor do rosto.

**O resultado é sempre igual?**
No Kodecz, o quadro *N* sai com o mesmo conteúdo, em ordem ou fora de ordem. O texto animado pode variar até 2 níveis de cor em 255, o que não se vê.

**Onde aprendo mais?**
No [lançamento do Kodecz](/blog/lancamento-kodecz) e no resumo do artigo sobre [agentes de IA fazendo vídeo](/blog/kodecz-agentes).

O Kodecz é o motor que a Konecz usa nos vídeos que posta todo dia para os clientes. Se você quer o vídeo pronto, sem escrever nada, veja os [planos da Konecz](/) ou o [portfólio](/portfolio).
