動画短尺スキル
短尺(10秒以下)は、現在のテキスト動画生成モデルにとって最適な長さです。 これらのモデルは1つのショットと1つのアイデアに優れており、複数カットの ナラティブには弱いです。呼び出しごとに1ショットを計画してください。
特殊ケース:hyperframes-htmlはフォトリアルなテキスト動画生成モデルではありません。
これはローカルのHTMLからMP4へのレンダラーです。このモデルでは、映画撮影や「現実世界」のカメラ物理を
ロールプレイしないでください。ブリーフをモーションデザインカード/タイトルフレーム/製品インタースティシャルとして
扱い、最大1つの確認質問をしたらすぐに実行に移してください。
リソースマップ
video-shortform/
├── SKILL.md
└── example.html
ワークフロー
ステップ0 — プロジェクトメタデータを読む
videoModel、videoLength(秒)、videoAspect。これらは
ハードロックです — 選択したモデルがサポートする範囲にプロンプトを制限します
(Seedance 2は最大10秒、Kling 4は最大10秒+画像から動画への変換に対応、
Veo 3はオーディオ付きで8秒に対応)。
ステップ1 — ショットを計画する
モデルを呼び出す前にショットリストを作成してください:
| スロット | 内容 |
|---|---|
| 被写体 | フレーム内に何があるか? |
| カメラ | 固定/パン/プッシュイン/軌道? |
| 照明 | キーライトの方向+色温度 |
| モーション | 何が、どのペースで動くか?被写体の動き vs カメラの動き。 |
| サウンド | アンビエントBGM?(モデルがオーディオをサポートしている場合のみ) |
通常は、これをユーザーに1文の計画として表示してから実行に移します — ユーザーは安価に方向転換できます。
hyperframes-htmlの場合は、ユーザーが発見フォームに回答したら、
事前のナレーションをスキップしてください。計画を実際の生成プロンプトにまとめて、
すぐに実行に移します。
ステップ2 — プロンプトを作成する
使用するモデルが好む形式を使用します(Seedance:モーション+カメラ+ムード、
Kling:被写体+カメラ+スタイル、Veo:被写体+撮影技法+サウンド)。
プロジェクトのvideoAspectとvideoLengthはAPIパラメータに直接バインドし、
散文に記述しないでください。
hyperframes-htmlの場合は、カメラのリアリズムプロンプトではなく、
簡潔なモーションデザインブリーフを作成してください。被写体、レイアウト、パレット、
モーションの性質、全体的なトーンに焦点を当てます。環境チェック、不足しているサイドファイル、
「これから実行します」というステータス更新をナレーションするためにターンを使ってはいけません。
ステップ3 — メディア契約を介して実行する
統一ディスパッチャーを使用してください — プロバイダAPIを手動で呼び出さないでください:
node "$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 "<Step 2で作成したショットプロンプト>"
このコマンドはJSONを1行出力します:{"file": {"name": "...", ...}}。
バイナリデータはプロジェクトに保存され、FileViewerで自動的に再生されます。
ステップ4 — 引き継ぎ
以下を含む応答を返します:ショットの概要、ディスパッチャーが返したファイル名、 ユーザーがバリエーションを希望する場合のアイデアを1文。
hyperframes-htmlの場合は、応答を特に短く保ちます:何がレンダリングされたか、
ファイル名、そして具体的なバリエーションアイデア1つ。
ハードルール
- 1ターンにつき1ショット。複数ショットのタイムラインはハイパーフレーム/ インタラクティブ動画スキルの担当であり、ここでは扱いません。
videoAspectに正確に一致させること — 再レンダリングは時間がかかります。- ファイルを保存せずに動画を送信しないこと — ユーザーはファイルビューアで 再生できるものを期待しています。
- 基盤モデルが失敗した場合(NSFWフィルター、コンテンツポリシー、 タイムアウト)、エラーをそのまま報告してください。サイレントリトライはしないでください。
- レンダリングが「送信された」「開始された」「実行中である」と主張しないでください。
od media generateをすでに呼び出していない限り。