/video — 本地 AI 影片片段
工具:content-studio MCP → generate_video, generate_image, mux_audio,
free_memory, job_status。
1. 詢問 — 一次提問搭配選項
使用 AskUserQuestion(Claude Code)/ question(OpenCode);否則使用編號列表。
跳過使用者已提供的資訊。
| 問題 | 選項 |
|---|---|
| 模型 | 快速 — MiniMax-H3 4-bit(41 GB,quality:"fast")· 最佳 — MiniMax-H3 8-bit(70 GB,quality:"quality") |
| 形狀 | 直式 Reel 512×896 · 橫式 896×512 · 方形 640×640 |
| 長度 | ~2 秒(49 幀) · ~4 秒(97 幀) · ~8 秒(193 幀) |
| 起始點 | 僅文字 · 先產生靜態圖片再動畫化 · 自己的圖片(詢問路徑) |
片段會附帶自動生成的配樂。模型會向上取整幀數(49 → 56 幀,24 fps 下約 2.3 秒)。一個小的 512×896 片段在快速模型下約需 2 分鐘。
直式畫面適合人物與街景,但寬廣的地平線鏡頭(海洋、風景)在 512×896 下有時會橫向輸出 — 此類場景建議使用橫式,或在使用片段前檢查一幀。
2. 準備
- 「先產生靜態圖片再動畫化」:執行
generate_image(品質預設,相同長寬比)並將其路徑傳給first_frame_image。 - 使用 8-bit 模型前,請呼叫
free_memory()— 它需要約 70 GB 記憶體。 - 撰寫鏡頭風格的提示詞:主體 + 動作,攝影機運動(推軌、環繞、手持、慢推入),光線,氛圍。每個片段一個鏡頭。
3. 生成
generate_video(prompt, quality, width, height, num_frames, first_frame_image) →
輪詢 job_status(job_id, wait_seconds=40) 直到完成。
對於多鏡頭作品,將每個鏡頭生為獨立的片段,然後交給 /reel(HyperFrames 編輯)進行剪輯、配上音樂與字幕。
4. 交付
提供 MP4 檔案路徑(位於 ~/ai/content-studio/outputs/video/ 下)、時長與大小。
建議:重新生成(新隨機種子)、加入音樂(/song 後執行 mux_audio),或串成一個 Reel。
長時間工作
工具呼叫約 45 秒內回傳(MCP 客戶端超時為 60 秒)。如果結果顯示 status: "running",請持續呼叫 job_status(job_id) — 每次呼叫最多等待 40 秒 — 並在呼叫間隔告知使用者進度訊息。即使對話或 MCP 伺服器重新啟動,工作仍會繼續執行;list_jobs() 可重新找到它們。