MiniMax Hailuo 2.3 教程：AI 视频创作

MiniMax Hailuo 2.3 是一款强大的 AI 视频生成工具，能够生成运动逼真、富有电影感的视频。你可以在 APIMart 上通过 MiniMax Hailuo 2.3 API 使用它，它提供两种工作流：文生视频，以及基于单张首帧图的图生视频，适合开发者、工作室和教育工作者。以下是你需要了解的要点：

• 主要功能：可生成 768p 或 1080p 视频，768p 下时长为 6 或 10 秒，1080p 下为 6 秒。MiniMax 表示，2.3 相比早期版本在肢体动作和微表情上都有改进。
• 价格：截至 2026 年 10 月，最低为 Fast 在 768p 下每秒 $0.0248。Fast 在 768p 下约为标准版的一半价格，在 1080p 下约便宜 40%。
• 配置：注册 APIMart、生成 API 密钥，然后按简单的三步流程操作：提交任务、轮询状态、从任务结果中下载视频。
• 优化建议：用 Fast 模型做图生视频草稿，需要文生视频或最终渲染时切换到标准版，并用 CCR（镜头、角色、反应）框架写出清晰的提示词。

这份指南把视频创作流程讲清楚，帮你在控制成本的同时获得高质量结果。

核心要点

• APIMart 上的 MiniMax Hailuo 2.3 通过两种工作流生成 768p 或 1080p 片段：文生视频，以及基于单张首帧图的图生视频。它没有尾帧输入，也没有主体参考（subject reference）输入。
• 所有工作流都遵循同样的异步三步流程：发送 POST 请求拿到 task_id，每 10 秒轮询一次 GET /v1/tasks/{task_id} 直到状态为 completed，然后从 data.result.videos[0].url[0] 下载 MP4；结果保留 72 小时。
• 截至 2026 年 10 月，APIMart 上 Hailuo 2.3 的价格从 768p 下 MiniMax-Hailuo-2.3-Fast 每秒 $0.0248，到 1080p 下标准版每秒 $0.072 不等。
• prompt_optimizer 参数默认为 true；如需严格按原文生成，可设为 false。运镜可以使用放在提示词开头的 15 个方括号中文指令，例如 [推进]。
• 768p 支持 6 或 10 秒，1080p 仅支持 6 秒，提示词上限 2,000 个字符；Fast 模型必须传 first_frame_image，同时 prompt 仍然必填。
• Fast 在 768p 下约为标准版一半的价格，在 1080p 下约便宜 40%，所以可以先用 Fast 在 768p 下做图生视频原型，再按最终渲染需要选择模型和分辨率。

在 APIMart 上配置 MiniMax Hailuo 2.3

创建并配置 APIMart 账号

首先，前往 apimart.ai 注册一个免费账号。登录后，进入控制台的 「API Key Management」 页面，生成一个新的 API 密钥，并务必立即复制保存，因为它只会显示一次^[5]。

接着，在模型控制台或 API 文档中搜索 MiniMax-Hailuo-2.3 或 MiniMax-Hailuo-2.3-Fast。这样可以确认模型可用，并在编写第一个 API 请求之前查看端点细节。

账号准备好、API 密钥也保管好之后，下一步就是配置开发环境。

开发前的准备

APIMart 的 API 支持多种语言，包括 Python（通过 requests）、JavaScript/TypeScript（通过 axios）和 cURL。请求使用 JSON 格式，并需要 Bearer token 进行鉴权。

为了保护 API 密钥，请把它存放在 os.environ["APIMART_API_KEY"] 这样的环境变量中，而不是硬编码在脚本里。

视频生成是一个异步过程，流程如下：把任务提交到 POST https://api.apimart.ai/v1/videos/generations，从 data[0].task_id 拿到 task_id，轮询 GET https://api.apimart.ai/v1/tasks/{task_id}，等状态变为 completed 后，从 data.result.videos[0].url[0] 下载视频。APIMart 没有公布固定的渲染耗时，它取决于分辨率、时长和当前负载^[3]。

环境配置好、也清楚了整体流程之后，就可以专注于管理预算和优化用量。

跟踪预算与设置用量上限

以下是截至 2026 年 10 月 APIMart 上各版本的每秒价格^[6]，当前价格以模型页为准。

举例来说，用标准版生成一个 6 秒 768p 片段约 $0.29，用 Fast 版本则约 $0.15，大约一半。在 1080p 下，6 秒片段标准版约 $0.43，Fast 约 $0.25，便宜约 40%。比较实用的做法是：先用 MiniMax-Hailuo-2.3-Fast 在 768p 下做图生视频原型，再根据最终渲染需要切换分辨率和模型。当前价格请以模型页为准。

APIMart 的账单面板可以实时查看消费情况。由于费用按生成视频的秒数计算，这在跑批量任务时尤其方便。

核心视频生成工作流

文生视频工作流

从文本生成视频是一个很直接的三步流程：提交、轮询、下载。

• 创建任务：向 https://api.apimart.ai/v1/videos/generations 发送 POST 请求，带上 model、prompt、duration 和 resolution。文生视频要使用标准版 MiniMax-Hailuo-2.3，因为 Fast 必须传首帧图。请求返回后，你会在 data[0].task_id 拿到 task_id。
• 轮询状态：用 task_id 每 10 秒查询一次 GET /v1/tasks/{task_id}。任务进行中时，状态为 pending 或 processing。完成后，状态变为 completed。
• 下载视频：从 data.result.videos[0].url[0] 读取视频 URL，并把 MP4 保存到你自己的存储里。结果保留 72 小时。

这里有一个重要参数：prompt_optimizer。它默认为 true，模型会优化你的提示词，以提升视频画面质量。不过，如果你需要精确控制，例如品牌内容中措辞必须严格一致，可以把它设为 false ^[3]。

运镜方面，APIMart 上的 Hailuo 2.3 支持 15 个方括号中文指令，按原样放在提示词开头：[左移] / [右移]（向左 / 向右平移）、[左摇] / [右摇]（向左 / 向右摇镜）、[推进] / [拉远]（推近 / 拉远）、[上升] / [下降]（上升 / 下降）、[上摇] / [下摇]（上摇 / 下摇）、[变焦推近] / [变焦拉远]（变焦推近 / 变焦拉远），以及 [晃动]（晃动）、[跟随]（跟随）和 [固定]（固定）^[3]。

在文生视频的基础上，图生视频工作流通过一张起始图片来锚定画面，能提供更多控制。

图生视频工作流

图生视频使用 first_frame_image 参数，可以传公开 URL 或 Base64 data URI。MiniMax-Hailuo-2.3 和 MiniMax-Hailuo-2.3-Fast 都支持；对于 Fast，first_frame_image 必填，prompt 也仍然必填。MiniMax 自己的文档建议使用 JPG、JPEG、PNG 或 WebP 文件，小于 20MB，短边至少 300px，画面比例在 2:5 到 5:2 之间 ^[2]。

这个工作流和文生视频一样，也是三步结构。区别在于，你提供的图片决定了起始画面，而文本提示词决定了画面如何演变。这让它非常适合营销或教育场景，比如让一张产品图或示意图过渡成一段动画。

制作更长视频的一个实用技巧，是截取已完成片段的最后一帧，作为下一个任务的 first_frame_image。这样无需额外调整，就能让多个片段之间的角色和场景保持一致 ^[9]。

APIMart 上的 Hailuo 2.3 不支持什么

APIMart 上的 Hailuo 2.3 只接受一个图片输入：first_frame_image。它没有 last_frame_image，也没有主体参考输入，所以这个模型无法做首尾帧过渡，也无法做人脸参考类的工作流 ^[3]。

如果你需要这些功能，可以看看 APIMart 上的其他 MiniMax 模型：MiniMax Hailuo 02 API 支持首尾帧过渡，MiniMax H3 API 支持首尾帧输入，以及多模态参考图、参考视频和参考音频。

Hailuo 2.3 的两种工作流（文生视频和图生视频）共用同一套三步异步流程和运镜指令语法。在两者之间切换，只需要在 POST 请求里加上或去掉 first_frame_image。

Hailuo AI 视频大师课：从入门到精通（完整指南 2.3）

提升视频质量并降低成本

写出有效的提示词

清晰、准确的提示词是生成高质量视频的关键。一个好用的提示词结构是 镜头、角色、反应（CCR） 框架。它把场景拆成三部分：镜头在做什么、画面里是谁、发生了什么动作。例如：「[跟随] 镜头：缓慢跟拍；角色：一名身穿蓝色球衣的四分卫；反应：在芝加哥一场雪夜比赛中长传，体育场灯光营造出朦胧的光晕。」

加入具体的视觉风格和焦点细节，效果会有明显差别。像「写实」「电影级光影」或「动漫风格」这样的词，可以把模型引导到你想要的效果。加入细微的角色细节，比如「微微挑眉」或「若有所思的目光」，可以用上 MiniMax 为 Hailuo 2.3 强调的微表情改进 ^[4]。不过，不要在一个提示词里塞太多动作，否则容易出现别扭或抖动的运动。提示词上限为 2,000 个字符，目标是写得详细又精炼、清楚又有目的 ^[3][7]。

选择合适的时长与分辨率

选择视频分辨率和时长时，需要权衡各个选项。Hailuo 2.3 提供两种分辨率：768p 和 1080p。关键区别在于：1080p 片段限制为 6 秒，而 768p 支持 6 秒和 10 秒两种时长 ^[3]。

做初稿时，768p 的 6 秒片段是比较实用的选择。它们价格实惠，可以在不投入过多资源的情况下评估运动和构图。等你缩小了选择范围，再切换到更高分辨率来制作最终成品。

采用迭代式工作流

迭代式工作流是平衡质量和成本的关键。对于图生视频，两阶段流程很好用：先用 Fast 模型探索，再用交付所需的设置重新渲染最好的版本。

「在概念阶段，用 Hailuo 2.3 Fast 为同一个提示词生成 3–5 个变体。挑出最好的一个，再用 2.3 Standard 或 02 以 1080p 重新运行这个提示词作为最终输出。这样能少在失败的实验上烧额度。」- QWE AI Academy ^[8]

在 APIMart 上，一个 6 秒 768p 片段，Fast 约 $0.15，标准版约 $0.29，所以 Fast 在 768p 下大约是一半价格，在 1080p 下约便宜 40%。MiniMax 称 Fast 在批量创作上更快、更具性价比 ^[4]。先用 Fast 测试多个草稿，就能在为最终渲染花更多钱之前，找出最有潜力的版本。选择交付用的档位之前，请先用你自己的提示词对比两者的输出。

把 MiniMax Hailuo 2.3 视频接入生产

管理异步任务与输出文件

用 Hailuo 2.3 生成视频是一个三步异步流程：首先提交请求并拿到 task_id；然后轮询 GET /v1/tasks/{task_id} 直到状态为 completed；最后从 data.result.videos[0].url[0] 读取视频 URL 并下载。

如果用轮询，建议保持 10 秒的间隔，以免触发限流。对于较大的批量任务，可以把待处理的 task ID 放进队列，按统一的节奏轮询，而不是为每个任务开一个高频循环。

留意 status 字段，及时发现错误。如果状态显示为 failed，立即读取 error 字段用于排查或记录日志。文件生成后要尽快下载，结果保留 72 小时。为了在异步响应之间追踪任务，可以把每个 task_id 和你内部的生产 ID 一起保存，方便把结果对应回请求。

搭建一套高效的任务管理机制，能让你在控制成本和扩大规模时更加顺畅。

预算与规模化使用

Hailuo 2.3 按生成视频的秒数计费，所以成本计算很直接。例如，截至 2026 年 10 月，2,400 秒的 768p Fast 输出（每秒 $0.0248）约 $59.52，而同样时长的 768p 标准版约 $117.12。

为了控制成本，可以先用 Fast 做图生视频的初步渲染。截至 2026 年 10 月，在 APIMart 上 Fast 在 768p 下约为标准版一半的价格，在 1080p 下约便宜 40%。任务查询的响应里还包含 cost 字段，你可以记录每个任务的实际费用，而不必等月度账单。

「Hailuo 2.3 Fast 模型……以更低的价格更快地生成视频，最多可将批量创作成本降低 50%。」- MiniMax News ^[4]

规模化生产时，选择与你的工作量匹配的轮询方式：

如果你要处理大量并发任务，基于队列的 worker 更合适。简单的轮询循环适用于小规模或一次性任务。

结论

截至 2026 年 10 月，APIMart 上的 MiniMax Hailuo 2.3 最低 每秒 $0.0248（Fast，768p），让专业级 AI 视频制作只需很小的成本。例如，一个 6 秒 768p 片段，Fast 约 $0.15，标准版约 $0.29。

开始时，先配置好 APIMart 账号，再选择与创作目标匹配的工作流：标准版做文生视频，标准版或 Fast 做图生视频。用 CCR（镜头、角色、反应）方法打磨结果^[11]。对于更长的项目，可以截取每个片段的最后一帧作为下一段的起始帧，保持画面一致^[9]。

Fast 模型能带来明显的节省：在 768p 下约为标准版一半的价格，在 1080p 下约便宜 40%。可以用它做草稿和批量任务，在用你自己的提示词对比输出之后，再决定最终渲染用哪个模型和分辨率^[4]。

这种性价比也受到了关注：

「Hailuo 2.3 再次刷新了视频模型性价比的全球纪录……为企业和个人用户提供『同价更多』的体验。」- MiniMax 官方新闻^[4]

对于需要管理大规模视频生产的团队来说，上面介绍的集成策略非常有价值。基于队列的轮询、每个任务的 cost 字段，以及提示词模板，能让你更轻松地搭建可规模化的生产流水线，每周处理多个片段。

常见问题

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

APIMart 上的 Hailuo 2.3 没有主体参考输入，所以一致性主要来自首帧图和提示词。每个片段都从一张光线和角度统一的 first_frame_image 开始，并把上一段的最后一帧作为下一段的首帧。提示词要写得准确，清楚描述主体、动作和风格。先用 6 秒的短片段测试一致性，再进行更长或更高分辨率的视频。

如何同时查看大量视频任务的状态？

任务不多时，每隔 10 秒左右用 GET /v1/tasks/{task_id} 分别轮询即可。

任务较多时，把待处理的 ID 放进队列，由一个 worker 按统一的节奏轮询，遇到 HTTP 429 就退避。这样请求数量可控，也不容易超出限流。

为什么要关闭 prompt_optimizer？

当你需要对视频生成进行精确控制时，把 prompt_optimizer 参数设为 false。这样系统就不会自动改写你的提示词，确保模型直接按你的原文和要求生成。