Creator Video
ステップ1 — クリップを計画する
- 何が動くか — クリップごとに1つの被写体、1つのアクション、1つのカメラムーブ
(
references/video-prompting.md)。 - アスペクト比 — Shorts/Reels/TikTokは
9:16、それ以外は16:9。 - 長さ — デフォルト8秒；長いストーリーは後で結合する複数のクリップに分割。
- 開始フレーム? — 見た目が重要な場合（ブランド、キャラクター、商品）、最初に画像として最初のフレームを作成し（creator-image または
creator.py image）、承認を得てから--startでアニメーション化します。これが全プロバイダで最も信頼性の高い結果制御方法です。 - 終了フレーム / 参照 — トランジションや演出には
--end、アイデンティティには--ref。 - 解像度 — デフォルト
720p；要求があれば1080p。
ステップ2 — 生成
python3 scripts/creator.py video --prompt "<モーションプロンプト>" --out ./out/<スラッグ>.mp4 --ratio 16:9 --duration 8 [--start first.png] [--end last.png] [--ref ref.png] [--resolution 1080p]
動画生成には1～10分かかります。可能な限りバックグラウンドで実行し、その間に2つ目の生成を開始しないでください。
ステップ3 — 結果を処理する
status | 行うこと |
|---|---|
ok | python3 scripts/media.py probe <パス>；フレームを抽出して確認；パス、長さ、プロバイダを報告 |
needs_browser | requestフィールドを使用してreferences/browser-flow-browser.md（またはgemini）に従う；その後 creator.py adopt --src <ダウンロード> --out <パス> |
blocked | コンテンツが拒否された；ユーザーと一緒に修正する。回避しない |
failed かつ動画プロバイダが全くない | 以下の静止画フォールバックを使用し、実際のモーションを利用可能にするプロバイダをユーザーに伝える |
静止画フォールバック（常に利用可能）
- ターゲットのアスペクト比で
creator.py imageを使用して1～3枚の静止画を作成する。 python3 scripts/media.py still --image s1.png --out clip.mp4 --duration 6 --ratio 16:9 --motion in（静止画ごとに--motionを変える；media.py assembleで複数を結合）。
ステップ4 — 仕上げ（オプション）
- リフレーミング：
media.py reframe --video clip.mp4 --out clip-9x16.mp4 --ratio 9:16 --mode blur（被写体が中央にある場合はcrop）。 - キャプション：
.srtファイルを作成し、media.py captions --video clip.mp4 --srt subs.srt --out final.mp4。 - サウンド：
creator.py sfx/musicで生成し、media.py assembleでミックス（単一シーン）。
ルール
- 成功を報告する前に、ディスク上で（長さ > 0、期待されるアスペクト比）を確認する。
- ルートがクリップごとにクレジットを消費する場合（Flow、Higgsfield）、ユーザーが多数のクリップを要求した場合にその旨を伝える。
- 同じプロジェクトのクリップ間で「見た目を説明する一文」を統一する。
参考文献
references/video-prompting.md— ショットの公式、フレーム、参照references/providers.md— 動画の順序とフォールバックreferences/media-ops.md— 静止画、リフレーミング、キャプション、アセンブルreferences/browser-flow-browser.md、references/browser-gemini-browser.md