Habilidade de Vídeo Curto
Vídeos curtos (≤ 10s) são o ponto ideal para os modelos atuais de texto-para-vídeo — eles são excelentes para uma cena com uma ideia, mas mais fracos em narrativas com múltiplos cortes. Planeje uma cena por chamada.
Caso especial: hyperframes-html não é um modelo de texto-para-vídeo fotorrealista.
É um renderizador local de HTML para MP4. Para esse modelo, não simule cinematografia
ou física de câmera do "mundo real". Trate o briefing como um cartão de design de movimento /
quadro de título / interstício de produto, faça no máximo uma pergunta esclarecedora
e despache imediatamente.
Mapa de recursos
video-shortform/
├── SKILL.md
└── example.html
Fluxo de trabalho
Etapa 0 — Leia os metadados do projeto
videoModel, videoLength (segundos), videoAspect. Estes são
bloqueios rígidos — ajuste o prompt ao que o modelo escolhido suporta
(Seedance 2 tem limite de 10s; Kling 4 suporta até 10s + imagem-para-vídeo;
Veo 3 suporta 8s com áudio).
Etapa 1 — Planeje a cena
Escreva a lista de cenas ANTES de chamar o modelo:
| Campo | Conteúdo |
|---|---|
| Sujeito | O que está no quadro? |
| Câmera | Estática / panorâmica / aproximação / órbita? |
| Iluminação | Direção chave + temperatura |
| Movimento | O que se move, em que ritmo? Movimento do sujeito vs movimento da câmera. |
| Som | Ambiente de fundo? (apenas se o modelo suportar áudio) |
Normalmente, mostre isso ao usuário como um plano de uma frase antes de despachar — eles podem redirecionar sem custo.
Para hyperframes-html, pule a narração extra antes do despacho depois que o
usuário responder ao formulário de descoberta. Resuma o plano no prompt de geração
real e despache imediatamente.
Etapa 2 — Componha o prompt
Use o formato que o modelo upstream prefere (Seedance: movimento + câmera +
humor; Kling: sujeito + câmera + estilo; Veo: sujeito + cinematografia +
som). Vincule o videoAspect e videoLength do projeto diretamente aos
parâmetros da API; nunca os coloque em prosa.
Para hyperframes-html, escreva um breve briefing de design de movimento em vez de um
prompt de realismo de câmera. Concentre-se em sujeito, layout, paleta, característica
de movimento e tom geral. Não gaste turnos narrando verificações de ambiente,
arquivos laterais ausentes ou atualizações de status "estou prestes a despachar".
Etapa 3 — Despache via o contrato de mídia
Use o despachante unificado — não chame APIs de provedores manualmente:
node "$OD_BIN" media generate \
--project "$OD_PROJECT_ID" \
--surface video \
--model "<videoModel dos metadados>" \
--aspect "<videoAspect dos metadados>" \
--length <videoLength segundos> \
--output "<slug-curto>-<segundos>s.mp4" \
--prompt "<prompt da cena montado na Etapa 2>"
O comando imprime uma linha de JSON: {"file": {"name": "...", ...}}.
Os bytes chegam no projeto; o FileViewer o reproduz automaticamente.
Etapa 4 — Entrega
Responda com: resumo da cena, o nome do arquivo retornado pelo despachante e uma frase sobre o que tentar se o usuário quiser uma variação.
Para hyperframes-html, mantenha a resposta especialmente curta: o que foi
renderizado, o nome do arquivo e uma ideia concreta de variação.
Regras rígidas
- Uma cena por turno. Linhas do tempo com múltiplos cortes pertencem a uma habilidade de hyperframes / vídeo interativo, não aqui.
- Corresponda exatamente a
videoAspect— re-renderizações são lentas. - Nunca envie um vídeo sem salvar o arquivo — o usuário espera algo para reproduzir no visualizador de arquivos.
- Quando o modelo subjacente falhar (filtro NSFW, política de conteúdo, timeout), relate o erro textualmente. Não tente novamente silenciosamente.
- Não afirme que uma renderização foi "enviada", "iniciada" ou "está em execução"
a menos que você já tenha chamado
od media generate.