MiniMax Hailuo 02 使用指南：完整教程

MiniMax Hailuo 02 是一款强大的 AI 模型，可以生成电影级质感的视频，并精确控制画面、运动和特效。你可以在 APIMart 上通过 MiniMax Hailuo 02 API 使用它。它支持文生视频、图生视频和首尾帧过渡，能生成最高 1080p 的高质量短片。下面是你需要了解的要点：

• 主要功能：可以用文本提示词、首帧图片或首尾帧图片生成视频，并直接在提示词里描述运镜。
• 价格：截至 2026 年 10 月，APIMart 上 1080p 片段为每秒 $0.08；当前价格以模型页为准。
• 配置：生成 API 密钥，按参数组织请求，并通过异步轮询获取视频。
• 应用场景：非常适合广告、产品展示、故事板和培训视频。

开始之前，先注册 APIMart 账号、保管好 API 密钥，然后按照下面的分步指南生成视频。使用具体的提示词和清晰的运镜描述，可以最大程度提升视频质量。对于更长的项目，可以用一致的画面把多个片段拼接起来，或者尝试 Kling V3 API 等其他电影级生成方案。

核心要点

• MiniMax Hailuo 02 可以通过 APIMart 生成文生视频、图生视频和首尾帧过渡片段，最高 1080p，模型 ID 为 MiniMax-Hailuo-02。
• 流程是：创建 APIMart 账号，在 API Key Management 中生成只显示一次的密钥，向 https://api.apimart.ai/v1/videos/generations 发送 JSON 请求体，然后每 15–30 秒轮询一次 /v1/tasks/{task_id}，直到状态为 completed。
• 关键参数包括 prompt、5 或 10 秒的 duration、512p / 768p / 1080p 的 resolution、以公开 URL 或 Base64 传入的 first_frame_image 和 last_frame_image，以及默认开启的 prompt_optimizer。
• 截至 2026 年 10 月，APIMart 价格为 512p 每秒 $0.0104、768p 每秒 $0.04、1080p 每秒 $0.08；完成的视频从 data.result.videos[0].url[0] 读取，结果保留 72 小时，请尽快保存文件。
• 在 APIMart 上，1080p 只支持 5 秒片段，且没有原生音频；超过 10 秒的视频可以把上一段的最后一帧作为下一段的 first_frame_image 串联起来。

MiniMax Hailuo 02 一览

在 APIMart 上开始使用 MiniMax Hailuo 02

账号设置与 API 密钥获取

首先，前往 apimart.ai 注册账号。如果你在团队中工作，APIMart 支持创建组织。这项功能让所有人共用一个中心余额，协作更方便，也不需要互相交换个人凭证。

账号准备好后，给共享余额充值。这份余额可用于 APIMart 上的所有模型，包括用于专业级视频生成的 Veo 3.1 API 等高端模型。接着，进入控制台的 API Key Management 页面，生成一个 API 密钥。

注意：API 密钥只会显示一次。 一定要复制下来并安全保存，比如放在密码管理器或密钥保管库里。在代码中使用时，从环境变量（例如 APIMART_API_KEY）读取，而不是直接写死在代码里。这样即使代码被分享或上传到版本控制系统，也能降低泄露风险。你发出的每个 API 请求都会在授权请求头中带上这个密钥：

Authorization: Bearer YOUR_API_KEY

对于团队来说，组织功能是集中管理访问权限的好办法，不必共享个人账号凭证 ^[2]。API 密钥准备好后，就可以配置请求参数并开始生成视频了。你也可以试试 Grok Imagine Video API 等其他高质量方案。

MiniMax Hailuo 02 请求的关键参数

保管好 API 密钥之后，就需要用正确的参数组织请求。"model": "MiniMax-Hailuo-02" 字段是必填的，另外还有几个参数。下面是最重要的几项：

有一个重要细节：视频生成是异步的。 发送请求后，API 返回的是 task_id，而不是视频本身。你需要每 15–30 秒轮询一次 /v1/tasks/{task_id}，直到状态变为 "completed"。视频生成好后要尽快下载：结果保留 72 小时 ^[1]。

参数设置好之后，就可以专心写出有效的提示词，充分发挥 MiniMax Hailuo 02 的能力。

如何写出有效的提示词

好的提示词是生成高质量视频的关键。一个结构完整的提示词包含六个要素：镜头或运镜、主体及描述、动作、场景、光线，以及风格或氛围。比如，与其写一句笼统的「一个女人走在城市里」，不如写得更具体：「跟拍镜头：一位穿红色大衣的女人在黄昏时分快步走过被雨水浸湿的曼哈顿街道，霓虹灯倒映在湿漉漉的路面上，电影黑色风格。」

想让视频更有动感，可以在提示词开头用平实的语言描述运镜，比如「缓慢推近」「跟拍」或「固定镜头」。APIMart 的 Hailuo 02 文档没有列出方括号运镜指令；本文后面介绍的 15 个方括号中文运镜指令，是 Hailuo 2.3 文档中的内容。

处理复杂场景时，保持 prompt_optimizer 为 true。这项功能会自动完善和扩展你的描述，通常不费什么力气就能得到更流畅、更连贯的视频 ^[1]。

如何在 Hailuo 02 中创作电影级 AI 视频

分步指南：用 MiniMax Hailuo 02 生成视频

如何发出一个基础的文生视频 API 请求

API 密钥和提示词都准备好了，发出第一个请求就很简单。向 https://api.apimart.ai/v1/videos/generations 发送 POST 请求，在请求头里带上 Bearer Token，并使用类似下面的 JSON 请求体：

{
  "model": "MiniMax-Hailuo-02",
  "prompt": "Tracking shot: a lone astronaut walks across a red desert at golden hour, dust swirling around their boots, cinematic wide-angle style.",
  "duration": 5,
  "resolution": "1080p"
}

重要： 1080p 分辨率只支持 5 秒片段。如果要 10 秒视频，需要把分辨率降到 768p 或 512p。价格取决于分辨率和时长。截至 2026 年 10 月，768p 为每秒 $0.04，1080p 为每秒 $0.08；当前价格请见模型页。

提交请求后，API 会在 data[0].task_id 返回一个 task_id，状态为 submitted。渲染耗时取决于分辨率、时长和当前负载，所以要持续轮询，直到任务完成。

如何使用图生视频功能

图生视频请求需要额外传入一个参数：first_frame_image。它可以是公开 URL（例如 https://example.com/start.jpg），也可以是 Base64 编码的 Data URL 字符串。请确保图片符合规定的文件类型、大小和画面比例要求。

由于图片已经提供了画面内容，你的提示词应该描述动作，而不是场景的视觉细节。比如，如果起始图是桌上的一件商品，像 "Slow zoom in. Product rotates gently, soft studio lighting, clean white background" 这样的提示词，就是在告诉模型如何让它动起来。输出分辨率会与输入图片的尺寸相匹配，所以使用高质量的原图对获得清晰效果至关重要。

想做更进阶的效果，可以在 first_frame_image 之外再传入一个 last_frame_image。这样会生成两张图之间的过渡视频，非常适合产品揭晓、前后对比，或者大型项目中的场景转场。

请求配置好之后，留意 API 响应来获取生成的动画视频。如果项目需要集成音频，可以考虑支持同步声音生成的 Veo 3.1 API。

读取 API 响应并下载输出

轮询 GET https://api.apimart.ai/v1/tasks/{task_id}。当任务状态变为 completed 时，视频 URL 在 data.result.videos[0].url[0]。没有单独的文件 ID 或下载接口。状态流转如下：

每 15–30 秒轮询一次 /v1/tasks/{task_id}，直到状态变为 completed。之后从返回的 URL 下载视频。结果保留 72 小时，请尽快保存到你自己的存储里 ^[1]。

如果你用 Python，可以用 requests.get(video_url).content 下载视频并保存为 .mp4 文件，其中 video_url 就是任务响应里的 data["result"]["videos"][0]["url"][0]。

最后，一定要检查 API 响应中的 code 字段。值为 200 表示请求成功，但你仍然需要关注任务状态，以发现可能的渲染错误 ^[1]。

提升视频质量与工作流集成

打磨提示词与参数设置

想提升视频质量，可以按这个格式组织提示词：[主体与动作]、[物理/环境元素]、[运镜]、[光线/氛围]、[质量描述] ^[7]。例如：「一位咖啡师把冒着热气的牛奶倒进浓缩咖啡，液体在慢动作中旋转，缓慢推近，温暖的咖啡馆灯光，电影级质感。」这种方式能帮助模型更有效地模拟真实的运动和氛围。

如果你需要明确的运镜标签，APIMart 上的 MiniMax Hailuo 2.3 API 支持 15 个方括号中文运镜指令，按原样写在提示词开头即可 ^[3]。可以参考下表：

prompt_optimizer 功能默认开启，通常能提升输出质量。除非你需要模型严格按特定脚本生成，否则建议保持开启。如果你优先考虑速度，并且能接受稍微不那么精致的效果，可以设置 fast_pretreatment: true 来缩短预处理时间 ^[1][6]。

提示词和设置调好之后，把它们接入更完整的流水线，进一步提升制作质量。

用 APIMart 搭建多模型流水线

Hailuo 02 与负责音频和长序列的工具搭配使用时效果最好。它擅长生成画面动感十足的 B-roll，比如水、火或布料，但它不生成音频。为了弥补这一点，可以在后期制作中搭配 MiniMax Audio 工具，例如用 Speech 2.8 做配音，用 Music 2.6 做配乐 ^[8]。对于品牌或商业项目，可以先用图像模型生成一张基础画面，再把它作为 first_frame_image 输入 Hailuo 02，从而精确控制构图 ^[7]。

如果视频超过 10 秒，可以截取已完成片段的最后一帧，作为下一个请求的 first_frame_image。这样有助于让多个片段之间的角色细节和环境光线保持一致 ^[8]。

错误处理与 API 最佳实践

即使提示词和流水线都打磨好了，问题仍然可能出现。按照下面的最佳实践，可以更有效地排查问题并优化 API 响应。

Hailuo 02 最常见的两类失败是不支持的分辨率/时长组合和无效的图片输入。务必确认分辨率和时长设置是兼容的 ^[1][6]。对于图生视频任务，MiniMax 自己的文档建议源图小于 20MB、短边大于 300px、画面比例在 2:5 到 5:2 之间，格式为 JPG、PNG 或 WebP ^[5]。

任务失败时，一定要查看任务响应中的 error 字段，它提供的细节能帮你快速解决问题。在生产环境中，保持适度的轮询间隔，并用指数退避重试，这样可以减少不必要的 API 调用，让工作流保持响应。

结论：核心要点

下面快速总结一下 MiniMax Hailuo 02 作为视频生成工具的突出之处。

MiniMax Hailuo 02 能以极高的精度实现电影级视频创作。得益于 NCR 架构，它的参数量是早期模型的 3 倍，训练数据是 4 倍 ^[7]，因此能为水、火、烟和布料等复杂元素生成高度逼真的效果。

截至 2026 年 10 月，通过 APIMart 使用 768p 为每秒 $0.04，1080p 为每秒 $0.08 ^[2]，无论是专业制作还是创意实验，它都是很实用的选择。

这个模型的突出功能包括：

• 图生视频工具，实现精确控制。
• 在提示词层面描述运镜（例如「跟拍」「缓慢推近」），获得专业感的镜头效果。
• 尾帧连续性，确保长序列中的过渡流畅。

请注意，在 APIMart 上 1080p 片段限制为 5 秒（MiniMax 官方发布文写的是 6 秒）。对于更长的视频，768p 是很好的替代方案，能以更低的价格生成 10 秒片段 ^[1]。

凭借这些功能，MiniMax Hailuo 02 可以让你的视频制作流程更上一层楼。

常见问题

如何生成超过 10 秒的片段？

MiniMax Hailuo 02 的单个片段最长 10 秒，而且 10 秒片段需要 768p 或 512p（1080p 只支持 5 秒）。如果需要更长的视频，可以生成多个 10 秒片段并串联起来，把上一段的最后一帧作为下一段的 first_frame_image。

对于 10 秒的文生视频片段，请在请求中包含以下参数：

• duration: 10
• resolution: "768p"
• model: "MiniMax-Hailuo-02"

提交请求后，轮询任务直到状态为 completed，然后从 data.result.videos[0].url[0] 下载视频。

任务失败了怎么办？

如果视频生成任务没有成功，先查看 HTTP 状态码和响应中的 error 对象来定位问题。常见情况如下：

• 400：参数无效，例如不支持的分辨率和时长组合。
• 401：API 密钥鉴权有问题。
• 402：账户余额不足。
• 429：触发了限流。

对于限流错误（HTTP 429）或服务器相关问题（HTTP 5xx），可以采用_指数退避_，也就是在每次重试之间逐渐拉长等待时间。同时，再次检查输入参数，并确保提示词不包含敏感内容，以免触发校验错误。

如何让多个片段之间的角色保持一致？

要在 MiniMax Hailuo 02 中保持角色一致，可以让每个片段都从一张清晰、光线良好的角色 first_frame_image 开始，并把上一段的最后一帧作为下一段的首帧。如果要处理多个片段，在提示词里写上一致的光线细节。为了让视觉衔接更顺畅，各镜头之间的机位角度要对齐，后期制作时也可以考虑使用交叉淡化或匹配剪辑等柔和的转场。这些技巧有助于打造连贯而精致的叙事。