从首帧构图延展动态
先用参考图片确立主体、场景和起始构图，再通过文字描述希望发生的动作。创作重点因此从“画面应该长什么样”转向“画面如何动起来”，适合已有视觉素材的项目，也便于围绕同一首帧尝试不同的镜头方案。
Overview
API
Pricing
规格与接口特性
在选型前明确容量、输入输出与调用方式。
- 创作方式
- 图生视频导演模式，以参考图片启动创作
- 输入内容
- 首帧图片 URL（first_image_url）与文字提示词（prompt）
- 原生控制重点
- 运动精确控制、提示词遵循、预设摄像机设置
- 调用入口
- POST /hailuo/videos；model=minimax-i2v-director；action=generate
- 任务方式
- 支持 async 异步提交与 callback_url 结果回调
- 结果交付
- 视频链接 video_url，附任务 ID 和状态信息
原生导演能力体现于运动与镜头表达；本平台调用采用首帧图片、提示词及任务结果管理。
核心能力
了解 minimax-i2v-director 能为你的工作带来什么。
让运动服务叙事
Director 的重点是减少运动随机性，让动作更贴近创作意图。提示词可以分别交代主体行为与镜头运动，例如人物缓慢转头、镜头向前推进；将意图拆开表达，比堆叠抽象风格词更便于组织清晰的动态叙事。
突出电影化镜头表达
I2V-01-Director 的原生设计结合预设摄像机设置与增强的提示词遵循能力，强调镜头对故事的作用。使用时可围绕景别变化、视线焦点和运动方向描述画面，把一个明确的镜头意图作为生成目标，而非只要求画面热闹。
适用场景
从具体任务出发，找到模型发挥作用的位置。
产品图片转展示镜头
输入已经确认外观与构图的产品图，再描述缓慢推进、主体保持稳定等镜头意图，生成用于展示的视频素材。适合在拍摄前探索产品呈现方式；交付后仍应检查包装文字、标识和细节是否符合品牌使用要求。
角色分镜动态预演
以角色设定图或分镜画面作为首帧，写清人物动作、目光方向以及镜头移动，生成可供讨论的动态预演。导演、设计师与剪辑师可以据此交流镜头节奏，再决定哪些动作保留、哪些构图需要重新设计。
视觉素材生成工作流
应用可将图片链接与镜头描述一起提交，采用异步任务记录生成进度，完成后取得视频链接供预览或剪辑。适合把设计素材库接入视频创作流程，让每次生成都能关联原图、提示词和对应的任务结果。
如何选择这个模型
结合任务复杂度、输入材料与预期结果选择。
已有图片，且在意怎么动
minimax-i2v 与 minimax-i2v-director 都从参考图片出发；Director 的明确定位是加强创作控制。若主要目标是为静态素材添加动态，可从普通图生视频工作流开始；若镜头方向、动作安排和提示词贴合程度是评审重点，导演模式更值得优先尝试，而不是按版本名称判断所有画质指标。
按创作起点区分图生与文生
I2V-01-Director 与 T2V-01-Director 同属导演模型系列，但创作起点不同。已经确定视觉形象时，图生模式便于以首帧组织后续动作；只有文字构想时，应选择文生视频型号。minimax-i2v-director 不应被当成无需图片的通用文生入口，也不要套用其他 Hailuo 版本的规格。
开始使用
从一次小规模任务到正式接入。
准备任务与材料
明确目标、必要输入与输出要求，使用真实业务样例作为起点。
在 API 调试区试用
打开试用页，确认此入口支持的参数，再提交小规模任务查看结果。
按 API 文档接入
保留完整模型 ID，使用文档规定的请求格式，并在 Pricing 页确认计费规则。
使用边界
在正式使用前，了解输出质量与能力范围。
- 导演模式增强的是创作控制，不等于逐帧动画编辑器，也不保证每个动作都精确复现。建议每次围绕一个主要动作和一种镜头运动组织提示词，避免同时要求互相矛盾的视角、运动方向或叙事变化。
- 首帧是创作的起点，不是全程锁定外观的承诺。对角色身份、产品结构、文字标识等有严格要求的任务，应检查生成视频中的变化，尤其关注运动、遮挡和视角改变后的细节，再决定是否用于最终交付。
- 该型号适合从参考图片生成动态素材，不宜直接按完整成片工具使用。配音、字幕、剪辑和音画同步应纳入后续制作计划；也不要将其他视频版本的高分辨率、时长或音频能力自动套用到这个型号。
常见问题
解答使用 minimax-i2v-director 时的常见疑问。
minimax-i2v-director 需要准备什么图片？
需要准备作为起始画面的参考图片，并通过 first_image_url 提交链接。建议先确定主体、构图和场景，再用 prompt 描述运动意图；它是图生视频导演模式，不应省略图片后当作文生视频型号使用。
它与普通 minimax-i2v 有什么选择差别？
两者都采用参考图片创作视频，Director 更强调运动控制、镜头表达与提示词遵循。若你需要比较不同运镜方案，或对动作安排有明确要求，可优先尝试导演模式；这不代表所有画质指标都必然更高。
怎样写更适合导演模式的提示词？
将主体动作与镜头动作分开写，再补充必要的场景变化。例如先描述人物转向窗边，再描述镜头缓慢推进。尽量保持单个镜头的目标清晰，避免把多个场景切换、复杂动作和矛盾运镜压进同一段指令。
如何提交任务并拿到生成视频？
向 /hailuo/videos 发送生成请求，指定 model 为 minimax-i2v-director、action 为 generate，并携带图片链接和提示词。可采用 async 异步方式或设置结果回调，利用 task_id 关联任务，再从完成结果取得 video_url。
Director 是否代表可以逐帧控制镜头？
不是。它侧重让生成动作和镜头表达更贴近提示词，而不是提供逐帧时间线或关键帧编辑。需要精确安排每一帧、完成多镜头拼接或同步配音时，应把生成结果作为素材，再进入剪辑和后期制作流程。
模型资料 · 更新日期：2026-10-01。调用参数与计费规则请查看 API 和定价栏目。
Pricing
$0.16· per generation
Top-up
You pay$13,584for 142,800 credits · $0.0951 / credits46% OFF
You're billed in credits. Pick a top-up tier to see its per-credit rate — the larger the top-up, the cheaper each credit.
Quickstart
Try the API
API Key
Please obtain an API Key first
This is only a basic call example. See the full docs for more parameters and advanced usage.
View Docs