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 ótimos para uma tomada com uma ideia, mais fracos em narrativas multi-corte. Planeje uma tomada 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 finja cinematografia ou física de câmera "do mundo real". Trate o brief como um cartão de design de movimento / 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. Estas são restrições rígidas — 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 tomada
Escreva a lista de tomadas ANTES de chamar o modelo:
| Slot | Conteúdo |
|---|---|
| Sujeito | O que está no quadro? |
| Câmera | Estática / panorâmica / aproximação / órbita? |
| Iluminação | Direção principal + temperatura |
| Movimento | O que se move, em que ritmo? Movimento do sujeito vs. movimento da câmera. |
| Som | Base ambiente? (apenas se o modelo suportar áudio) |
Normalmente, mostre isso ao usuário como um plano de uma frase antes de despachar — eles podem redirecionar com baixo custo.
Para hyperframes-html, pule a narração extra pré-despacho depois que o usuário tiver respondido ao formulário de descoberta. Transforme 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 + clima; Kling: sujeito + câmera + estilo; Veo: sujeito + cinematografia + som). Vincule videoAspect e videoLength do projeto diretamente aos parâmetros da API; nunca os coloque em prosa.
Para hyperframes-html, escreva um brief conciso de design de movimento em vez de um prompt de realismo de câmera. Foque em sujeito, layout, paleta, caráter 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 contrato de mídia
Use o despachante unificado — não chame APIs de provedor manualmente:
"$OD_NODE_BIN" "$OD_BIN" media generate \
--project "$OD_PROJECT_ID" \
--surface video \
--model "<videoModel from metadata>" \
--aspect "<videoAspect from metadata>" \
--length <videoLength seconds> \
--output "<short-slug>-<seconds>s.mp4" \
--prompt "<assembled shot prompt from Step 2>"
O comando imprime uma linha de JSON: {"file": {"name": "...", ...}}. Os bytes vão para o projeto; o Visualizador de Arquivos reproduz automaticamente.
Etapa 4 — Passe a bola
Responda com: resumo da tomada, 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 tomada por vez. Linhas do tempo multi-tomada 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, tempo limite), relate o erro textualmente. Não tente novamente silenciosamente.
- Não afirme que uma renderização foi "enviada", "iniciada" ou "está sendo executada" a menos que você já tenha chamado
"$OD_NODE_BIN" "$OD_BIN" media generate.