模型类型
视频生成
MiniMax H3 属于 Hailuo 视频模型家族，不是 MiniMax M3 语言模型。
MiniMax H3 API
通过 EvoLink 统一视频 API 接入 MiniMax H3。该模型也常被搜索为 Hailuo 03 或 Hailuo 3，支持 2K 文生视频、首尾帧图生视频和多模态参考素材生视频，可先在线测试再接入。
MiniMax视频生成可用
768p 视频每秒低至 ~$0.076$0.080 官方价格-5%
文生视频图生视频参考视频首帧 / 尾帧多模态参考异步 API
生产路由已上线
模型特点
MiniMax 下一代 Hailuo 视频路由，2K / 768p 输出
适用场景
广告创意、电商、短剧叙事、多模型流水线
输入
文本、首尾帧或参考素材
输出
2K / 768p 视频（MP4），4-15 秒
先试用 MiniMax H3，再接入 API。
在线测试 MiniMax H3 的输出效果、预估积分消耗，并根据输入类型选好模型 ID，再接入异步 API。
创建样例
选择路由、填写提示词并设置参数。就绪
历史记录
生成结果保留 24 小时，需要的请及时下载。
生成记录会显示在这里
MiniMax H3 按输出秒数计费。
三个路由共用同一套秒价，768p 按 2K 的 8/13 计费。参考视频的秒数会加到输出时长上，所以带参考视频的任务比同长度的纯文本生成更贵。
首次测试成本
文生视频 768P 4 秒 —— 最便宜的一次请求，不带任何输入素材-5%最低收费
积分20.672
一条 4 秒 768P 样片
约合$0.304
10 美元积分约可测试 31 次。
这同时也是最低消费：768p 4 秒是最便宜的合法请求，任何 MiniMax H3 任务都不会低于这个价。
测试预算参考
按首测参数估算：768P 4 秒$10
约 31 次测试
适合首次验证。
$50
约 164 次测试
适合提示词与参考素材迭代。
$100
约 328 次测试
适合接入生产前的完整验证。
常见费用示例
短文生视频测试T2V 4 秒 768p
~$0.304-5%
~20.672 cr·~$0.320 官方价完整时长视频T2V 15 秒 768p
~$1.140-5%
~77.52 cr·~$1.200 官方价参考视频测试R2V 4 秒 + 3 秒参考 768p
~$0.532-5%
~36.176 cr·~$0.560 官方价示例按你所在用户组的当前秒价计算。参考视频秒数与输出时长一并计费。
MiniMax H3 价格
| 模式 | 768P | 2K | 计费依据 |
|---|---|---|---|
| 文生视频标准路由 | $0.076/s-5% 5.168 cr/s$0.080 官方价 | $0.124/s-5% 8.398 cr/s$0.130 官方价 | 输出视频秒数 |
| 图生视频标准路由 | $0.076/s-5% 5.168 cr/s$0.080 官方价 | $0.124/s-5% 8.398 cr/s$0.130 官方价 | 输出视频秒数 |
| 参考视频图片或音频参考 | $0.076/s-5% 5.168 cr/s$0.080 官方价 | $0.124/s-5% 8.398 cr/s$0.130 官方价 | 输出视频秒数 |
| 参考视频视频参考 | $0.076/s-5% 5.168 cr/s$0.080 官方价 | $0.124/s-5% 8.398 cr/s$0.130 官方价 | 输出 + 参考视频秒数 |
文生视频
标准路由 · 输出视频秒数
768P $0.076/s · 5.168 cr/s $0.080/s-5%
2K $0.124/s · 8.398 cr/s $0.130/s-5%
图生视频
标准路由 · 输出视频秒数
768P $0.076/s · 5.168 cr/s $0.080/s-5%
2K $0.124/s · 8.398 cr/s $0.130/s-5%
参考视频
图片或音频参考 · 输出视频秒数
768P $0.076/s · 5.168 cr/s $0.080/s-5%
2K $0.124/s · 8.398 cr/s $0.130/s-5%
参考视频
视频参考 · 输出 + 参考视频秒数
768P $0.076/s · 5.168 cr/s $0.080/s-5%
2K $0.124/s · 8.398 cr/s $0.130/s-5%
按输出视频秒数计费。参考图和参考音频不增加输入秒数，参考视频会增加。
单任务最低计费额等于最便宜的合法请求（768p × 4 秒）。失败、过期与被拒的任务全额退款。
| 项目 | 适用场景 | 价格 | 积分 |
|---|---|---|---|
| 输入图像第 6 张起 | 单次请求输入图像超过 5 张时适用。 | $0.038 / image-5% $0.040 官方价 | 2.584 cr |
单次请求前 5 张输入图像免费，从第 6 张起按张计费并叠加在秒费之上；最低消费只作用于秒费部分。
MiniMax H3 适合做什么。
MiniMax H3 是 MiniMax Hailuo AI 视频家族的下一代多模态模型，不是面向编程和 Agent 的 MiniMax M3 语言模型。它在 EvoLink 上以三个路由提供服务——文本驱动、首尾帧驱动和参考素材驱动，共用同一个 API Key 与积分余额。
输入
文本 / 首尾帧 / 参考素材
输出
MP4 视频
时长
4-15 秒
分辨率
768p / 2K
参考素材
最多 12 个文件：9 图 / 3 视频 / 3 音频
MiniMax H3：三条路由，三个 Model ID
每种生成模式都是独立的 Model ID，共用同一个 API Key 和积分余额——按输入类型选择路由。
MiniMax H3 文生视频
minimax-h3-text-to-video从文本提示词生成 2K 或 768p 视频。
MiniMax H3 图生视频
minimax-h3-image-to-video让首帧、尾帧或首尾两帧动起来。
MiniMax H3 参考生视频
minimax-h3-reference-to-video由图片、视频与音频参考共同引导生成视频。
MiniMax H3 模型信息
以下是 EvoLink 已验证并对外提供的 API 请求规范。MiniMax 尚未公布的字段一律留空，不做推测。
输入能力
文本、首尾帧、参考图 + 参考视频 + 参考音频
上游的帧输入与参考输入互斥，因此 EvoLink 拆成三个独立模型 ID 对外提供。
API 模型 ID
minimax-h3-text-to-video / -image-to-video / -reference-to-video
按输入类型选择模型 ID；每个路由按各自的严格参数白名单校验请求体。
输出与时长
2K / 768p，4-15 秒，MP4
768p 已开放，且是不传 quality 时的默认档，按 2K 单价的 8/13 计费。
API 价格
按输出秒数计费，768p / 2K 两档
参考视频秒数会加进计费时长，参考图和参考音频不会。
任务生命周期
异步提交、轮询或回调，不支持取消
任务状态为排队 / 生成中 / 已完成 / 失败。上游没有取消端点，因此失败即退款。
MiniMax H3 API 主要参数
以下字段覆盖主要接入决策。各路线的完整请求与响应示例请查看 API Reference。
modelstring根据输入选择文生、图生或参考生视频的 EvoLink 模型 ID。
默认值: 按路线选择
promptstring描述画面、动作与运镜，最长 7000 字符。
默认值: 必填
durationinteger输出 4–15 秒，按输出时长计费。
默认值: 4
qualityenum可选 768p 或 2k；768p 按 2K 秒价的 8/13 计费。
默认值: 768p
aspect_ratioenum文生视频必须显式指定比例（21:9、16:9、4:3、1:1、3:4、9:16）；参考生视频默认 adaptive；图生视频跟随输入帧。
默认值: 16:9 / adaptive
image_start / image_endstring仅图生视频：首帧、尾帧或两者的 HTTP(S) URL。
默认值: 可选
image_urls / video_urls / audio_urlsstring[]仅参考生视频：最多 9 张图、3 条视频、3 条音频（合计 12 个文件）；参考视频秒数计入计费。
默认值: []
callback_urlstring接收任务终态的公开 HTTPS URL；同时保存 task ID 作为轮询回退。
默认值: 可选
两种方式接入 MiniMax H3：EvoLink API 或 Agent
需要嵌入产品、运行批量任务时，直接使用 EvoLink API；需要快速创作、试验或让 Agent 完成接入时，可在 Codex、Claude 或 Gemini 中调用。两种方式共用 EvoLink API Key、余额、模型路由和任务记录。
方式一
通过 EvoLink API 接入
适合：产品后端、批量任务、自动化工作流
在你的服务端直接调用 EvoLink 统一视频 API，自己控制模型 ID、参数、任务队列、callback 和结果存储。
- 1在 Playground 用真实 brief 验证效果和成本
- 2在控制台创建 EvoLink API Key
- 3按上方路由卡选择与任务匹配的模型 ID
- 4提交任务，通过轮询或 HTTPS callback 获取结果
方式二
在 Agent 中调用
适合：Codex、Claude、Gemini 中的创作与开发任务
把输出目标、素材和验收标准交给 Agent，它可以选择路由、组装请求、跟踪任务并返回结果，不需要你手写每一步。
- 1在本地环境变量中设置 EVOLINK_API_KEY，不要写进代码或 Prompt
- 2描述输出目标、参考素材和关键参数
- 3让 Agent 调用 MiniMax H3 路由并保存 task ID
- 4让 Agent 轮询到最终状态、下载结果并报告失败原因
MiniMax H3 可以用在哪些视频工作流
Hailuo 家族一贯被验证的那些真实场景，现在已经可以通过经过验证的路由直接调用。
MiniMax H3 文生视频创作
针对分镜、社交短视频和创意概念，评测提示词遵循、运镜、动作、物理合理性和可用输出率。
MiniMax H3 图生视频动画
支持首帧驱动、尾帧收束或首尾帧过渡，同时保持商品形状、角色身份、构图与视觉风格。
MiniMax H3 广告创意生产
评测批量吞吐、审核失败、重试、品牌一致性和每条通过广告的成本，而不是只看一条演示视频。
MiniMax H3 电商商品视频
在面向客户使用前，检查商品保真、可控运动、宽高比交付和 Logo 处理。
MiniMax H3 短剧与叙事内容
在连续镜头中比较角色一致性、镜头衔接和运镜指令，并用参考图、参考视频锚定风格。
含 MiniMax H3 的多模型视频产品
把 MiniMax H3 作为一条路由与 Seedance、Kling、Wan 并行，并保留已测试的回退方案，避免绑定单一供应商。
MiniMax H3 API 代码示例与错误处理
示例展示最短可运行流程：创建任务、保存返回的 task ID，然后轮询或等待 HTTPS callback。完整参数与响应字段见 API 标签页。
cURL
curl -X POST https://api.evolink.ai/v1/videos/generations \
-H "Authorization: Bearer $EVOLINK_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "minimax-h3-text-to-video",
"prompt": "A female captain before a vast observation window as the fleet jumps away, cinematic slow dolly-in",
"duration": 5,
"quality": "768p",
"aspect_ratio": "16:9",
"callback_url": "https://your-domain.com/webhooks/video-task-completed"
}'
# Save the returned task ID, then query:
curl https://api.evolink.ai/v1/tasks/{task_id} \
-H "Authorization: Bearer $EVOLINK_API_KEY"参数校验失败
对照上方参数卡逐项检查：取值范围、可选枚举、素材数量和文件类型必须与所选路由一致。
鉴权或余额问题
检查 Authorization Bearer Token，并在控制台确认可用余额与任务计费。
内容或素材被拒
检查肖像权、品牌素材、可读文字、敏感内容以及输入素材的合规性。
任务失败或超时
MiniMax H3 任务最终状态为失败时不扣费。保留 task ID，查看最终状态，先判断是校验、审核还是执行环节出错，再决定是否重试。
未收到 callback
callback_url 必须是公网 HTTPS 地址，不能是 localhost 或内网地址。始终保留 task ID 作为轮询兜底。
MiniMax H3 值得加入你的视频模型栈吗？
按当前可验证的 API 请求规范做选择；当任务超出这些限制时，保留另一条可用路由。
适合优先测试的情况
- 需要生成 2K、4-15 秒的视频。
- 产品同时需要文生视频、首尾帧图生视频和参考素材生视频。
- 创作输入包含参考图片、视频或音频。
- 应用已经支持异步轮询或回调。
- 会在多个视频模型之间评估有效成片成本。
建议选择其他路线的情况
- 必须输出 4K 或超过 15 秒的视频。
- 任务必须同步返回，或提交后必须可以取消。
- 需要无声片段——H3 每条输出都带音频。
- 无法在结果链接生成后的 24 小时内保存 MP4。
- 需要开放权重或本地部署。
如何判断 MiniMax H3 是否适合生产
用真实任务和验收标准衡量可用输出、一致性、总成本与运行可靠性，而不是只看精选演示片。
可用视频是否更多？
在完整尝试集上衡量提示词与参考遵循、时序一致性、可见瑕疵和最终验收的视频数量。
角色和商品是否更稳定？
用相同源素材比较角色、脸部、服装、Logo、商品形状、构图和风格保持。
完整工作流是否更好？
除了生成速度，还要加入排队、限速、失败退款、审核、重试、人工修正和后期编辑。
是否值得进入生产？
计算每条最终采用视频的成本，并确认回调、保留规则、监控、回滚和多模型回退能否适配现有产品。
MiniMax H3 在你的视频技术栈中的位置
| 维度 | MiniMax H3 | Hailuo 2.3 | Other video routes |
|---|---|---|---|
| 主要定位 | 下一代 Hailuo 路由 | 有完整文档的 Hailuo 基线 | 跨厂商对比与回退 |
| 生成模式 | 文生 + 图生（首尾帧）+ 参考 | 文生 + 图生 | 视模型而定 |
| 参考输入 | 图片 + 视频 + 音频 | 仅图片 | 视模型而定 |
| 分辨率 | 2K / 768p | 768p / 1080p | 480p 至 4K |
| 时长 | 4-15 秒 | 6 秒 / 10 秒 | 3-15 秒 |
| 计费方式 | 按输出秒数（含参考视频秒数） | 按条计费 | 按秒或按条 |
主要定位
MiniMax H3下一代 Hailuo 路由
Hailuo 2.3有完整文档的 Hailuo 基线
Other video routes跨厂商对比与回退
生成模式
MiniMax H3文生 + 图生（首尾帧）+ 参考
Hailuo 2.3文生 + 图生
Other video routes视模型而定
参考输入
MiniMax H3图片 + 视频 + 音频
Hailuo 2.3仅图片
Other video routes视模型而定
分辨率
MiniMax H32K / 768p
Hailuo 2.3768p / 1080p
Other video routes480p 至 4K
时长
MiniMax H34-15 秒
Hailuo 2.36 秒 / 10 秒
Other video routes3-15 秒
计费方式
MiniMax H3按输出秒数（含参考视频秒数）
Hailuo 2.3按条计费
Other video routes按秒或按条
MiniMax H3 关键细节
三个 MiniMax H3 模型 ID
根据你提交的是提示词、首尾帧还是参考素材，分别使用 minimax-h3-text-to-video、minimax-h3-image-to-video 或 minimax-h3-reference-to-video。
MiniMax H3 严格参数白名单
只接受文档中列出的字段。seed、image_url、first_frame_image 等历史别名会返回 400 并指名该字段，而不是被静默忽略。
MiniMax H3 异步生产流程
提交任务、轮询状态或使用回调，再取回成品 MP4。不提供取消能力；失败、过期与被拒的任务全额退款。
为什么通过 EvoLink 接入 MiniMax H3 API
成本透明
生成前就能看到积分与秒价，参考视频秒数一并计入。
统一 API
在 Hailuo、Seedance、Kling 等视频路由之间切换，无需重建鉴权与计费。
统一余额
所有路由的积分、消耗与模型用量都在同一个控制台查看。
任务状态追踪
清楚看到任务处于排队、生成中、已完成还是失败，失败自动退款。
模型自由选择
把 MiniMax H3 作为一条已测试路由，需要时切换到其他家族。
Hailuo 模型家族
在同一个 EvoLink 账户和 API Key 下对比 Hailuo 各代路由，再按分辨率、时长、参考方式和成本选择模型。
MiniMax H3 之外的其他视频模型
采用 MiniMax H3 前，先把它比较清楚
根据你的问题进入家族对比、发布更新或精确对比文章。
阅读 MiniMax H3 API 接入指南
三条路由的 cURL、Python 和 TypeScript 示例，涵盖异步提交、轮询、回调与错误处理。
MiniMax H3 发布时间线
已确认事实、媒体时间，以及 EvoLink 开放路由前使用的核验清单。
MiniMax H3 vs Hailuo 2.3
判断下一代模型需要拿出哪些证据，才值得从 Hailuo 2.3 升级。
MiniMax H3 vs Seedance 2.0
将 MiniMax H3 与当前可用的多模态音视频工作流比较。
MiniMax H3 vs Seedance 2.5
判断该用 H3 交付，还是切换到 2026 年 8 月 7 日已在 EvoLink 上线的 Seedance 2.5 API。
MiniMax H3 常见问题
MiniMax H3 是什么？
MiniMax H3 是 MiniMax Hailuo AI 视频家族的下一代多模态模型。它是视频模型，不是面向编程和 Agent 的 MiniMax M3 语言模型。
MiniMax H3 API、Hailuo 03 API 和 Hailuo 3 API 是同一个吗？
是。这三个名称指向 EvoLink 上同一组 Hailuo 家族视频 API 路由，产品主名称为 MiniMax H3 API。
MiniMax H3 可以用来做什么？
文生视频、带首尾帧控制的图生视频、参考素材驱动生成、广告创意、电商商品视频、短剧叙事内容和多模型视频产品。
现在可以通过 EvoLink 使用 MiniMax H3 吗？
可以。EvoLink 已通过统一视频接口提供 MiniMax H3 的三个路由，配套 API Key、积分余额、异步任务追踪和失败退款。
MiniMax H3 API 的模型 ID 是什么？
minimax-h3-text-to-video、minimax-h3-image-to-video 和 minimax-h3-reference-to-video。按输入类型选择，每个路由校验各自的参数集合。
MiniMax H3 API 价格是多少？
MiniMax H3 按输出视频秒数计费。默认档是 768p，按 2K 单价的 8/13 计费。生成前可在价格区和在线体验的预估中查看你所在用户组的当前秒价。
参考视频怎么计费？
参考视频的秒数会加到输出时长上：输出 5 秒 + 参考视频 3 秒按 8 秒计费。参考图和参考音频不增加输入秒数。
MiniMax H3 参考素材有哪些输入限制？
参考视频路由最多接受 9 张图片、3 个视频和 3 个音频。视频和音频单个时长为 2-15 秒，每类素材总时长不超过 15 秒；音频可以单独使用，作为唯一的参考素材。
MiniMax H3 支持 4K、更长视频或取消任务吗？
不支持。输出为 2K 或 768p，时长 4-15 秒；上游没有取消端点，因此任务的 can_cancel 恒为 false，失败时全额退款。
MiniMax H3 和 Hailuo 2.3 有什么区别？
Hailuo 2.3 仍是按条计费的 Standard / Fast 基线，输出 768p / 1080p。MiniMax H3 增加了参考视频与参考音频输入、首尾帧控制、2K / 768p 输出和按秒计费。
如何获取 MiniMax H3 生成完成的视频？
提交异步任务后，轮询 GET /v1/tasks/{task_id} 或使用回调，再从已完成任务的响应中下载 MP4。
MiniMax H3 的结果链接可以使用多久？
生成完成后的视频链接有效期为 24 小时。请在链接过期前将 MP4 保存到你有权使用的存储中。