Magic Hour 图像转视频 是做什么的？
生成一段可用的短视频：先解决静态帧中的外观问题，再处理运动。除非用户仅要求提交，否则项目 ID 或排队任务视为未完成。
生成会消耗 Magic Hour 积分。当可用时，请使用已连接的 Magic Hour 创建 MCP，地址为 https://mcp.magichour.ai/。否则，请阅读 references/setup.md 了解 API 路由。在选择模型、时长、分辨率或价格前，请先发现当前 schema。
根据需求简报选择镜头方向；不要向非技术用户询问模型字段或运动提示模板。尊重现有预算。当创意决策被委托时，请自行检查并接受静态帧，然后继续处理视频，除非要求提供草稿审批。先展示剪辑片段，并在项目中保留技术记录。对于变换和揭示，请阅读 directing the moment；对于包含多个节拍的故事，请阅读 multi-shot direction。
对于首次结果或设置恢复，请阅读 first video and next edit。该文档定义了账户检查、合并预算、可恢复的任务记录和可重复使用的交付物。
定义镜头
提取或推断：
- 交付宽高比和分辨率
- 主体、产品、角色、场景以及所需的视觉细节
- 一个主要主体动作和一个镜头运动
- 必须保持不变的细节，尤其是身份、几何形状、包装、标志、文字、颜色、服装和背景
- 失败条件，例如面部扭曲、标签改变、不必要的剪切或文字不可读
将短片段限制在一个连贯的节拍内。如果用户想要多个镜头，请将每个镜头视为独立的审查起始帧和视频任务。应从相同的已批准身份参考中派生这些帧，而不是链接未经审查的编辑。选择能够保留交付物的运动：推拉镜头会改变主体大小和可用文字空间，而锁定相机配合受限制的光线或环境运动可以保留主要布局。
首先构建起始帧
选择以下一种途径：
- 已有可用的源图像： 当构图、服装、背景、灯光、产品放置或清理需要更改时，调用
ai_image_editor_create_image。同时描述所需的编辑和所有必须保持不变的内容。 - 没有源图像： 调用
ai_image_generator_create_image。AI 图像编辑器需要输入图像；不要向它发送仅包含提示的创建请求。 - 提供的图像已满足镜头要求： 跳过图像生成，直接为其添加动画。
以目标视频宽高比创建一张静态帧。当身份、产品几何形状、包装或品牌标识至关重要时，请使用授权参考。不要指望图像转视频能修复质量很差的源帧。
使用 wait_for_image_project 等待图像项目。预览完成的静态帧，如果存在裁剪错误、解剖结构问题、身份改变、产品变形、标志或文字不准确、意外文字、视觉伪像或缺少留白，请在动画生成前拒绝该帧。使用最小的有效编辑修复静态帧。第二次付费图像请求需要获得授权预算。
为已批准的帧添加动画
将确切批准的图像输出传递给 image_to_video_create_video。如果结果是本地文件，请先使用 references/setup.md 中的流程上传其原始字节；本地路径不是托管的 file_path。
围绕随时间的变化编写运动提示：
- 主体运动，包含明确的速度和方向
- 相机运动，或明确声明相机已锁定
- 环境运动，例如布料、蒸汽、头发、光线或粒子
- 保持固定的内容
- 时序和结束状态，包括在不希望淡出时的保持最终曝光
避免用新的视觉语言重新描述整个静态帧。这会导致模型重新设计主体。对于反应镜头：鱼在她肩膀旁慢慢游动；她注意到它，带着惊讶的微笑微微转身。缓慢推近镜头，保持她的脸和鱼分离。保留身份、衣服和场景。无剪切。 产品布局可能需要锁定主体并保护文字区域。当批准的帧将主体放置在右侧时，不要要求居中主体。
仅当当前 schema 显示所选的模型、分辨率和时长支持时，才使用结束帧。对于一般请求，优先使用实时推荐模型。仅当其 schema 描述所需控制时，才选择专业模型。将分辨率和时长匹配到要求的交付物。短预览仅测试短时间间隔，而不是较长时间片段上的稳定性。检查“静态帧加视频”的总成本是否超出现有授权，仅当超出时才询问。
提交视频一次，保留其项目 ID，并调用 wait_for_video_project。等待超时不意味着生成失败，也不应重新提交创建调用。
检查并交付
项目报告 complete 后，按原样使用返回的下载 URL。验证下载的尺寸、时长和音频存在。当播放可用时，观看完整片段，然后检查第一帧、中间帧、最后一帧以及任何可疑的过渡。仅靠三张静态帧无法证明没有闪烁。检查：
- 第一帧与批准的静态帧匹配
- 身份、产品形状、标志、文字和服装保持稳定
- 运动遵循要求的方向和速度
- 相机不会意外漂移或剪切；检查实际最终帧是否存在不想要的淡出或丢失主体，即使黑帧诊断是干净的
- 无扭曲、闪烁、融化、重复对象或突然的最终帧崩溃
- 任何生成的音频都是有意且连贯的
如果某个必需条件失败，请识别该条件，并更改最小的相关输入：外观问题改起始帧，运动问题改运动提示，仅当实时 schema 支持所需行为时才更改模型/分辨率。不要在用户预算之外花费积分进行另一次尝试。
在 portrait-to-koi 示例中，身份保持可识别，但要求的轻微转身变成了双向较大转身。纠正该运动时，保留已接受的静态帧。如果下载的画布与要求的比例略有不同，请在本地裁剪前检查完整动作路径；不要仅为了去除边缘像素而重新生成一个已被接受的作品。
返回完成的视频或可用链接、适用的保存位置、图像和视频项目 ID 以及任何重大限制。