Open Design Video Shortform 技能指南

技能概述

Video Shortform 專注於短視頻（≤ 10 秒）生成。呢個長度係當前 text-to-video 模型嘅最佳甜蜜點 — 佢哋擅長單一鏡頭（one shot）、單一意念（one idea），但唔擅長多鏡頭敘事。

支持模型：Seedance 2（最長 10s）、Kling 3/4（最長 10s + image-to-video）、Veo 3（8s + audio）、Sora 2。特殊情況：hyperframes-html 係本地 HTML-to-MP4 渲染器，適用於 motion design card / title frame / product interstitial。

觸發關鍵字

• video、clip、shortform、reel
• 短視頻、動效

什麼時候用

• 生成 3-10 秒嘅 product reveal 短片
• 做 motion teaser 或 ambient loop
• 用 AI 視頻模型生成產品展示
• 需要一個 MP4 文件直接放入項目

使用方法

工作流程

Step 0 — 讀項目元數據

確認 videoModel、videoLength（秒）、videoAspect。呢三個係 hard-locks，prompt 必須匹配模型支持嘅範圍。

Step 1 — Plan the shot

用 shotlist 規劃先於調用模型：

將呢個一句話計劃展示畀用戶，佢哋可以低成本轉向。

對於 hyperframes-html，跳過額外敘述，用戶答完 discovery form 後即刻 dispatch。

Step 2 — Compose the prompt

按上游模型偏好格式編寫：

將 videoAspect 同 videoLength 直接綁定到 API 參數，唔好放喺 prose 入面。

Step 3 — Dispatch

用統一 dispatcher，唔好手動調 provider API：

"$OD_NODE_BIN" "$OD_BIN" media generate \
  --project "$OD_PROJECT_ID" \
  --surface video \
  --model "<videoModel>" \
  --aspect "<videoAspect>" \
  --length <seconds> \
  --output "<slug>-<seconds>s.mp4" \
  --prompt "<assembled prompt>"

Step 4 — Hand off

回覆：shot summary、dispatcher 返回嘅文件名、一句 variation 建議。

硬規則

• 一鏡一輪 — 多鏡頭時間軸屬於 hyperframes / interactive-video 技能
• Aspect 精確匹配 — 重新渲染好慢
• 必須保存文件 — 用戶期望喺 FileViewer 入面可以播放
• 模型失敗報錯 — NSFW filter / content policy / timeout，原樣報告，唔好靜默重試
• 唔好假裝渲染已開始 — 除非你真係調用咗 media generate

輸出

• 一個 MP4 文件保存到項目文件夾
• 用戶可直接喺 FileViewer 播放
• 附一句 variation 建議

相關技能

• HyperFrames
• Motion Frames
• Sprite Animation