从已有画面展开创作
minimax-i2v 的核心工作方式是参考图片生成视频。你可以先确定主体、背景与构图，再提交首帧图片开展动态创作，不必只靠文字从头描述整个画面。适合已有设计稿、商品图片或插画素材，希望探索其动态表达的制作流程。
Overview
API
Pricing
规格与接口特性
在选型前明确容量、输入输出与调用方式。
- 创作方式
- 图生视频，以首帧参考图片作为输入
- 图片提交
- first_image_url 图片链接，不支持 Base64
- 文字引导
- prompt 描述动作、场景变化与创作意图
- 生成调用
- POST /hailuo/videos；model=minimax-i2v；action=generate
- 任务处理
- 支持 async 异步提交及 callback_url 结果回调
- 结果交付
- 返回 video_url 视频链接、task_id 与任务状态信息
以上列出本型号的创作方式与本平台调用功能，不将其他 Hailuo 版本的原生参数作为本型号规格。
核心能力
了解 minimax-i2v 能为你的工作带来什么。
用文字补充动态意图
首帧图片提供视觉起点，prompt 则用于说明希望发生的动作和场景变化。实际创作时，可围绕主体动作、环境动态与镜头意图组织描述，例如让人物转头或让背景中的水面起伏；这些是创作指令，而非逐帧执行的动画程序。
生成任务融入应用流程
视频生成可以采用异步方式处理：提交后先保存 task_id，再查询任务结果；也可以设置 callback_url，在完成后接收 JSON 回调。应用可据此将提交、等待与结果展示分开处理，最终通过 video_url 获取视频，避免把提交成功当作生成完成。
适用场景
从具体任务出发，找到模型发挥作用的位置。
商品静态图的动态试作
准备商品主视觉图片，在提示词中描述希望呈现的动态效果或镜头意图，生成用于评审的视觉片段。适合在正式拍摄或剪辑前探索表现方向；交付时仍应检查商品外形、包装文字与标识，确认画面符合展示要求。
插画与角色画面动态化
将完成的角色插画或场景图作为首帧，补充人物动作、背景变化与氛围描述，尝试把静态作品转为动态素材。建议先聚焦一个主要动作，观察角色细节与画面变化，再决定是否继续调整提示词或更换参考图片。
分镜方案的动态预览
已有分镜图时，可逐张选取画面作为首帧，并为各个镜头编写动态描述，生成便于讨论的预览素材。通过任务标识管理结果，再交由剪辑环节整理镜头顺序；这种方式用于验证创意，不等同于自动完成整部影片。
如何选择这个模型
结合任务复杂度、输入材料与预期结果选择。
已有图片时选择图生视频
minimax-i2v 与 minimax-t2v 的主要选择依据是创作起点：前者需要参考图片，后者面向文字生成视频。已有产品图、角色图或明确分镜时，选择 minimax-i2v 更契合素材条件；如果尚未确定视觉画面，希望直接从文字构思开始，则应考虑文生视频型号。
区分常规创作与导演模式
minimax-i2v 与 minimax-i2v-director 是不同的调用选项。前者适合以首帧和提示词开展图生视频；如果任务更强调导演式创作控制，可进一步考虑 director 型号。不要把导演模式的镜头设置直接套用到 minimax-i2v，也不要仅因同属 Hailuo 就假定控制功能相同。
开始使用
从一次小规模任务到正式接入。
准备任务与材料
明确目标、必要输入与输出要求，使用真实业务样例作为起点。
在 API 调试区试用
打开试用页，确认此入口支持的参数，再提交小规模任务查看结果。
按 API 文档接入
保留完整模型 ID，使用文档规定的请求格式，并在 Pricing 页确认计费规则。
使用边界
在正式使用前，了解输出质量与能力范围。
- minimax-i2v 的图片输入使用首帧链接，不接受 Base64。提交前应确认链接可供服务读取；仅有本地文件路径不能替代图片 URL。需要先将素材准备为可访问的链接，再结合提示词发起生成。
- 参考图片是生成起点，不是每一帧的精确约束。涉及商品文字、角色细节或复杂动作时，应检查成片是否符合要求；对必须严格保持的视觉元素，建议安排人工审核与必要的后期修整。
- 本型号应按图生视频任务使用，不应默认具备导演模式预设、尾帧控制、多参考图或音频创作功能。若项目需要精确剪辑、配音或跨镜头组织，应将这些环节纳入独立的制作流程。
常见问题
解答使用 minimax-i2v 时的常见疑问。
minimax-i2v 可以只输入文字吗？
应提供首帧参考图片链接，并结合文字描述进行创作。minimax-i2v 是图生视频型号，不适合按纯文字生成流程使用。若没有参考图片，希望从文字直接生成画面，可选择 minimax-t2v。
参考图片怎样提交，能用 Base64 吗？
通过 first_image_url 提交图片链接，不支持 Base64 编码。请先把图片准备为服务可读取的 URL，再发起请求；本地路径或编码后的图片字符串不能直接替代这个链接。
提示词应该重点描述什么？
建议重点说明希望发生的动作、环境变化与镜头意图，而不是重复列出图片中的所有细节。先围绕一个主要动态目标试作，再根据结果调整描述；提示词用于引导生成，不等同于精确的逐帧控制指令。
它与 minimax-i2v-director 是同一个型号吗？
不是。两者都是图生视频选项，但 minimax-i2v-director 是单独的导演模式型号，定位更强调创作控制。使用 minimax-i2v 时，应围绕首帧图片与提示词工作，不把导演模式的控制设置视为默认功能。
异步提交后如何获得视频？
设置 async=true 后，先保存返回的 task_id，再通过任务查询获取状态和结果；也可设置 callback_url 接收完成回调。生成完成后读取结果中的 video_url 获取视频，不要将收到任务 ID 视为视频已经完成。
模型资料 · 更新日期：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