Creator Video
Step 1 — 規劃片段
- 什麼會動 — 每個片段只有一個主體、一個動作、一個鏡頭移動
(
references/video-prompting.md)。 - 比例 — Shorts/Reels/TikTok 使用
9:16，其他情況使用16:9。 - 時長 — 預設 8 秒；較長的故事會分成多個片段，稍後再拼接。
- 起始幀？ — 如果外觀很重要（品牌、角色、產品），先將第一幀製作成圖像（
creator-image或creator.py image），獲得批准後，再使用--start將其動畫化。這是每個提供者上最可靠的控制結果方式。 - 結束幀 / 參考 — 用於過渡和揭示的
--end，用於身份識別的--ref。 - 解析度 — 預設
720p；當用戶要求時使用1080p。
Step 2 — 生成
python3 scripts/creator.py video --prompt "<動作提示>" --out ./out/<slug>.mp4 --ratio 16:9 --duration 8 [--start first.png] [--end last.png] [--ref ref.png] [--resolution 1080p]
影片生成需要 1–10 分鐘。盡可能在背景執行，並且不要同時開始第二個生成任務。
Step 3 — 處理結果
status | 操作 |
|---|---|
ok | python3 scripts/media.py probe <path>；提取一幀並查看；回報路徑、長度、提供者 |
needs_browser | 按照 references/browser-flow-browser.md（或 gemini）操作，使用 request 欄位；然後執行 creator.py adopt --src <download> --out <path> |
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拼接多個片段）。
Step 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