O que Habilidade de Vídeos Curtos faz?
Vídeos curtos (≤ 10s) são o ponto ideal para os atuais modelos de texto-para-vídeo — eles são excelentes em uma tomada com uma ideia, mas mais fracos em narrativas com múltiplos cortes. 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 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 limita a 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 da chave + temperatura |
| Movimento | O que se move e 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 de forma barata.
Para hyperframes-html, pule a narração extra antes do despacho depois que o usuário responder 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 o videoAspect e videoLength do projeto diretamente aos parâmetros da API; nunca os coloque em prosa.
Para hyperframes-html, escreva um briefing conciso de design de movimento em vez de um prompt de realismo de câmera. Foque no sujeito, layout, paleta, caráter do 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 provedor manualmente:
"$OD_NODE_BIN" "$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 tomada montado na Etapa 2>"
O comando imprime uma linha de JSON: {"file": {"name": "...", ...}}. Os bytes vão para o projeto; o FileViewer o reproduz automaticamente.
Etapa 4 — Finalize
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 de variação concreta.
Regras rígidas
- Uma tomada por vez. Linhas do tempo com múltiplas tomadas pertencem a uma habilidade de hyperframes / vídeo interativo, não aqui.
- Corresponda exatamente ao
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), reporte o erro literalmente. Não tente novamente silenciosamente.
- Não afirme que um render foi "enviado", "iniciado" ou "está em execução" a menos que você já tenha chamado
"$OD_NODE_BIN" "$OD_BIN" media generate.