MiniMax H3 怎么用：进同一个模型的五扇门

世上没有一个叫 MiniMax H3 的应用。它是一个模型，前面立着五扇门——这个浏览器、MiniMax 自家的应用、官方 API、转售平台，或者你自己显卡上的权重——所以「怎么用」完全取决于你走的是哪一扇。

五条路跑的是同一份权重，回来的都是 4 到 15 秒、24 fps、768P 或 2K 的 MP4，声音和画面在一起。变的是搭建时间、谁付钱，以及你到底有没有授权：托管的那几条全球开放，自己跑权重则在美国、欧盟、英国和韩国没有授权。

五条路，按搭起来的时间排

按「出第一条片子之前要干多少活」排，不是按我们希望你选哪一行排。

最后一列最要紧。MiniMax 的社区许可证把美国、欧盟、英国和韩国放在「适用地域」之外，而且这条排除跟着产出物走。托管的那几条不受影响。所以从伦敦或者旧金山看，第一到第四行是你的，第五行不是——这就是「MiniMax H3 怎么用」的大半个答案。这是摘要，不是法律意见。

第一条：在浏览器里，大约 90 秒

打一段镜头，按生成。不用注册、不用邮箱、不用银行卡——过一道机器人校验，就有一条 768P 的片子可以下载留着。免费引擎出的片没有声音，付费那一档才是音画同生。

你打的字不会直接送到裸权重上。它会走 MiniMax 的托管管线，跑那两段下载包里没有的东西：提示词理解与 2K。文生视频和图片生视频把每一个参数都摊开给你。

第二条：MiniMax 自家的应用

你拿到哪一对，取决于你在哪儿。全球是 hailuoai.video 上的 Hailuo AI 加 hub.minimax.io 的桌面客户端；中国大陆是 hailuoai.com 和 hub.minimaxi.com。两边都要账号，都用 MiniMax 自己的积分计费。

那里有一个命名陷阱等着。Hailuo 3 就是这个模型——MiniMax 自己的 OpenAPI 标题写的是 Hailuo-03。不带数字的 Hailuo AI 是那个应用，Hailuo 2.3 是上一代。

第三条：官方 API

在 platform.minimax.io 拿 key，中国账号则去 platform.minimaxi.com，然后指向对应的 base URL。模型 ID 是 MiniMax-H3，区分大小写。控制台会替你把调用拼出来；剩下的这些，是没有哪段示例代码会教你的。

这里没有任何东西是同步的

create 调用返回的是一个 task_id，不是视频。要一直轮询 GET /v2/query/video_generation/{task_id}，直到状态变成 succeeded，再从 content.url 读文件。不想轮询，就设 callback_url：MiniMax 会先发一个带 challenge 字段的校验请求，你必须在三秒内原样回传。

成功那一刻起，有两个钟同时开始走

是两个不同的钟，几乎所有人都把它们混成一个。成片 URL 有时效，所以任务一完成就下载并转存到自己那边；MiniMax 没有公布过这个时长，外面流传的「24 小时」是某家转售商的数。任务本身可以查询 7 天，之后同一个 task_id 会返回 invalid。

五件会让第一次调用失败的事

绊倒几乎所有人的是 ratio——文生视频必填，而且填成 adaptive 会被拒。content 数组里如果没有一项非空文本，返回错误码 2013。

真正会花钱的是最后一条：一个什么都没挂的参考类请求不会报错。 它会变成一个文生视频任务，返回 200 OK，然后照常收费。

第四条：转售平台，另一套词汇

有好几个平台把 H3 放在自己的字段结构后面，字段名和限制都是它们自己的。从某家转售商文档里抄来的代码，拿去打 api.minimax.io 是跑不通的：那边的 quality 在这边叫 resolution，aspect_ratio 在这边叫 ratio，模型 ID 也不带那种小写连字符。有些平台只收 2K——「H3 只能出 2K」这个说法就是从那儿来的；MiniMax 自己的 API 两个都收。

Context-IR 和 Regenerate-2K 不在下载包里

H3 分三段跑，开源的只有中间那一段。

• H3-Context-IR 把你的提示词和参考素材重写成一份结构化的镜头描述。
• H3-Base 一次前向传播里同时生成 768P 画面和它的声音。
• H3-Regenerate-2K 把那个结果连同原始上下文再送回模型跑一遍——这就是为什么小字能活下来，而不是被猜出来。

Hugging Face 上的权重是 H3-Base。另外两段留在托管侧。这就是为什么参数明明调得一点不差，本地渲染出来的东西还是比发布片平淡——你跑的是三段里的一段。

调托管 API，三段都替你跑了。更少人知道的是：那两段闭源的部分可以单独调用。MiniMax 自己的模型卡就记着一种混合搭法——你自己的 SGLang 部署跑 H3-Base，再加上官方的 Context-IR 与 Regenerate-2K API——用来复现托管 API 直接给你的那个 2K。自部署不是全有或全无。

第五条：你自己的显卡，以及什么时候别用我们

只有在许可证覆盖你的时候才走这条——上面那张表写了哪些地方不覆盖。它也管到产出物：在允许的国家渲染，发布到被排除的国家，你仍然在授权之外。MiniMax 在 platform.minimax.io/h3-license 接受申请。许可证逐条读里有其余部分。这是摘要，不是法律意见。

如果你确认自己没问题：ComfyUI 精简包是 42.47 GB，不是完整仓库那 498 GB，而且 ComfyUI v0.30.0 之后不装自定义节点就能读它。在 ComfyUI 里跑有文件目录结构；显卡什么时候能回本有那笔账。

有三种情况你不该用这个站。商用： 去 MiniMax 自家的 Hailuo 产品或者 API，因为这里做出来的一切都只供个人使用与评估。大批量，或者把 H3 塞进你自己的产品： 那是 API 的活。下个月还要用的文件： 自己留一份，我们不是档案馆。

大家最先问的那几个问题

有不花钱用 MiniMax H3 的办法吗？ 有，而且离你只有一次点击。第一条路给你一条 768P、五秒的片子，不用账号、不用银行卡，过一道机器人校验就行；这一条跑的是免费引擎，所以没有声音。登录之后会加 30 积分、7 天有效，够在免费引擎上再出 6 条。没有谁能让 H3 敞开了随便跑：每一个输出秒都是真实的 GPU 时间，在 API 上按 $0.08 计费。

MiniMax H3 是什么？ MiniMax 的全模态生成系统。它把文字、图片、视频和音频当作同一份上下文来读，返回 4 到 15 秒、24 fps 的 768P 或 2K 视频，32 kHz 立体声在同一次传播里出来。

什么时候发布的？ 2026 年 7 月 31 日宣布；开源权重 2026 年 8 月 2–3 日放出。社区许可证的日期是 8 月 2 日。

MiniMax H3 和 Hailuo 是一回事吗？ 一半是。Hailuo 3 是同一个模型。不带数字的 Hailuo AI 是那个消费级应用，Hailuo 2.3 是上一代模型。

API 的模型 ID 是什么？ MiniMax-H3，区分大小写。那种小写带连字符的 ID 属于转售商，不属于这个 API。

我的文生视频调用为什么一直失败？ 最常见的是 ratio——文生视频必填，而且拒收 adaptive。其次是 content 数组里没有非空文本项，那会返回错误码 2013。

多少钱？ 在 MiniMax 的按量付费价目表上，768P 每输出秒 $0.08，2K $0.13。作为参考的源视频按它自己的时长另算；前五张参考图和全部参考音频不收费。768P 便宜 38%，所以草稿就该待在那儿。

能在自己机器上跑吗？ 只在许可证允许的地方，而且只有 H3-Base。另外两段留在托管侧，不过本地部署仍然可以调它们。

片子生成完之后能改吗？ 不能靠一条编辑指令改。H3 没有编辑接口；哪份教程说有，它讲的是别的东西。视频是从参考通道重新进去的，然后照着它生成一条新片。

这里做的东西能商用吗？带水印吗？ 我们交回给你的东西一律不带水印——付费买到的从来不是去水印，是声音、2K 和时长。商用是唯一的「不行」：这里生成的一切都只供个人使用与评估，所有档位都一样，包括不花钱那一档。我们是独立第三方界面，没有资格把成片的商用权利授给你。要做商用，请走 MiniMax 自家的 Hailuo 产品或者官方 API，那两条路自带商用条款。这是摘要，不是法律意见。

---

「MiniMax H3 怎么用」最短的答案是文生视频。不用银行卡，不用账号，你下载走的东西归你。