Magic Hour 圖片轉影片
透過先解決靜態幀中的外觀問題，再處理動作，來產生可用的短影片。除非使用者僅要求提交，否則專案 ID 或排隊中的工作狀態皆為不完整。
產生過程會消耗 Magic Hour 點數。當可用的情況下，請使用已連接的 Magic Hour 創作 MCP 於 https://mcp.magichour.ai/。否則請閱讀 references/setup.md 以了解 API 路由。在選擇模型、時長、解析度或價格之前，請先探索目前的 schemas。
根據簡報選擇鏡頭方向；請勿向非技術使用者詢問模型欄位或動態提示詞的範本。尊重既有的預算。當創意決策被授權時，請自行檢查並接受靜態幀，然後繼續製作影片，除非已要求草稿審查。先顯示片段，並在專案中保留技術記錄。對於轉場和揭示，請閱讀 directing the moment；對於包含多個情節的故事，請閱讀 multi-shot direction。
對於首次結果或設定恢復，請閱讀 first video and next edit。其中定義了帳戶檢查、合併預算、可恢復的工作記錄以及可重複使用的交付物。
定義鏡頭
提取或推斷：
- 交付的長寬比和解析度
- 主體、產品、角色、設定及所需的視覺細節
- 一個主要主體動作和一個相機運動
- 必須保持固定的細節，特別是身分、幾何形狀、包裝、標誌、文字、顏色、服裝和背景
- 失敗條件，例如變形的臉、改變的標籤、不必要的剪輯或無法閱讀的文字
將短片保持在一個連貫的情節中。如果使用者想要多個鏡頭，請將每個鏡頭視為一個獨立的審查起始幀和影片任務。從同一張已批准的身分參考圖推導出這些幀，而不是串聯未審查的編輯。選擇能保護交付物的運動：推軌會改變主體比例和可用的文案空間，而鎖定的相機搭配受限制的光線或環境運動則可以保護主體佈局。
先建立起始幀
選擇一種方式：
- 已有可用的原始圖片： 當構圖、服裝、背景、燈光、產品擺放或清理必須改變時，呼叫
ai_image_editor_create_image。同時說明要求的編輯以及所有必須保持不變的內容。 - 沒有原始圖片： 呼叫
ai_image_generator_create_image。AI Image Editor 需要輸入圖片；請勿向其發送僅有提示詞的創作請求。 - 提供的圖片已滿足鏡頭需求： 跳過圖片生成，直接對其進行動畫化。
以預期的影片長寬比建立一個靜態幀。當身分、產品形狀、包裝或品牌形象至關重要時，請使用經授權的參考圖。不要期望圖片轉影片能修復劣質的原始幀。
使用 wait_for_image_project 等待圖片專案完成。預覽完成的靜態幀，如果出現裁切錯誤、解剖問題、身分改變、產品變形、標誌或文字不準確、非預期的文字、視覺偽影或缺少留白，請在動畫化之前拒絕它。使用最小的實用編輯來修正該靜態幀。第二次付費圖片請求需要獲得授權的預算。
將審查過的幀動畫化
將完全審查過的圖片輸出傳遞給 image_to_video_create_video。如果結果是本機檔案，請先使用 references/setup.md 中的流程上傳其原始位元組；本機路徑不是託管的 file_path。
撰寫關於隨時間變化的動態提示詞：
- 主體運動，具有明確的速度和方向
- 相機運動，或明確說明相機鎖定
- 環境運動，例如布料、蒸汽、頭髮、光線或粒子
- 保持固定不變的內容
- 時間點和結束狀態，包括在不需要淡出時的持續曝光
避免以新的視覺語言重新描述整個靜態幀。這會誘使模型重新設計主體。對於反應鏡頭：魚在她肩膀旁緩慢游動；她注意到並微笑著微微轉頭。緩慢推近以保持她的臉和魚分開。保持身分、衣服和場景。無剪輯。 產品佈局可能需要鎖定的主體和受保護的文案區域。當審查過的幀將主體放在右側時，不要要求主體居中。
僅在當前 schema 說明所選模型、解析度和時長支援結束幀時才使用。對於一般請求，優先選擇即時推薦的模型。僅在該模型的 schema 描述了所需控制項時，才選擇專門模型。將解析度和時長與要求的交付物匹配。短預覽測試的是短時間間隔，而非較長片段的穩定性。檢查靜態幀加影片的總成本是否超過現有授權，僅在不符合預期工作時提出詢問。
提交影片一次，保留其專案 ID，並呼叫 wait_for_video_project。等待超時並非生成失敗，也不構成重新提交創作呼叫的理由。
檢查並交付
在專案回報 complete 後，按原樣使用回傳的下載 URL。驗證下載的尺寸、時長和音訊存在。當可播放時觀看完整片段，然後檢查第一幀、中間幀、最後一幀以及任何可疑的轉場。僅靠三張靜態幀無法證明沒有閃爍。檢查：
- 第一幀與審查過的靜態幀相符
- 身分、產品形狀、標誌、文字和服飾保持穩定
- 運動遵循要求的方向和速度
- 相機沒有意外漂移或剪輯；檢查實際的最後一幀是否有非預期的淡出或主體遺失，即使黑幀診斷是乾淨的
- 沒有出現變形、閃爍、融化、重複物體或突然的最後一幀崩潰
- 任何生成的音訊都是有意義且連貫的
如果有一個必要條件失敗，請識別它並更改最小的相關輸入：外觀問題更改起始幀，運動問題更改動態提示詞，或僅在 live schema 支援所需行為時更改模型/解析度。不要在使用者預算之外花費點數進行另一次嘗試。
在 portrait-to-koi 範例中，身分保持可識別，但要求的輕微轉動變成了雙向的較大轉動。在修正該運動時，保留已接受的靜態幀。如果下載的畫布與要求的比例略有不同，請在進行本機裁切前檢查完整的動作路徑；不要為了移除邊緣像素而重新生成一個已被接受的片段。
回傳完成的影片或可用連結、適用的儲存位置、圖片和影片的專案 ID，以及任何重大限制。