MiniMax H3 API

通过 EvoLink 统一视频 API 接入 MiniMax H3。该模型也常被搜索为 Hailuo 03 或 Hailuo 3，支持 2K 文生视频、首尾帧图生视频和多模态参考素材生视频，可先在线测试再接入。

MiniMax-视频生成已上线

768p 视频每秒低至 ~$0.076-5%$0.080 官方价

文生视频图生视频参考视频2K / 768p 输出4-15 秒视频异步 API

生产路由已上线

已上线异步任务追踪

模型亮点

MiniMax 下一代 Hailuo 视频路由，2K / 768p 输出

适用场景

广告创意、电商、短剧叙事、多模型流水线

输入

文本、首尾帧或参考素材

输出

2K / 768p 视频（MP4）

在线体验价格模型指南 API

先试用 MiniMax H3，再接入 API。

在线测试 MiniMax H3 的输出效果、预估积分消耗，并根据输入类型选好模型 ID，再接入异步 API。

创建样例

选择路由、填写提示词并设置参数。

提示词

浏览提示词示例

Create a 5-second horizontal 16:9 cinematic short film.

Keep the woman highly consistent: young woman with dark wavy hair and bangs, black shirt, calm but tense expression, sitting alone in the back seat of a car. Keep the rainy car window, red and cyan neon reflections, dark interior, realistic city night atmosphere, shallow depth of field, and intimate film-noir mood.

Story conflict: she is not simply riding in a car. She has just made a decision that will betray someone she once trusted. Outside, someone is following her through the rain. She must choose whether to keep going or disappear before the car reaches the meeting point.

0-1s: Rain slides slowly down the car window. She sits still in the back seat, looking through the glass. Red neon light washes across her face like a warning.

1-2s: A phone on her lap vibrates and lights up, but the screen shows no readable text. She glances down, does not answer, and quietly tightens her hand around it.

2-3s: A bright pair of headlights appears behind the car, reflected in the wet window. Her eyes shift toward the reflection. She realizes the same car is still following.

3-4s: She stays calm. No panic. She turns the phone face down on the seat, then reaches into her coat and touches an old photograph or small envelope, as if saying goodbye to her old life.

4-5s: She looks toward the driver without raising her voice. Her lips barely move, silently implying: "Don't stop." Red light flashes across the window. End on her close-up through the rain-covered glass - no tears, no fear, only a cold final decision.

Style: realistic cinematic thriller, urban rainy night, neon reflections, film noir mood, restrained acting, subtle emotional tension, natural face movement, real skin texture, wet glass detail, low-light cinematography, soft film grain, shallow depth of field, intimate close-up, high-end independent crime film opening.

Avoid: exaggerated car chase, explosions, guns, fighting, crying, screaming, fake acting, overdramatic gestures, plastic skin, AI-looking face, changing identity, changing outfit, random text, subtitles, watermark, logo, distorted face, chaotic camera movement.

时长5s

画质

宽高比

预估：~$0.6241.99 cr

就绪

历史记录

生成记录会显示在这里

MiniMax H3 按输出秒数计费。

三个路由共用同一套秒价，768p 按 2K 的 8/13 计费。参考视频的秒数会加到输出时长上，所以带参考视频的任务比同长度的纯文本生成更贵。

首次测试成本

文生视频 - 4 秒 - 768p

4 秒 768p

积分20.672

一条 4 秒 768p 样片

约合$0.30

10 美元积分约可测试 33 次。

这同时也是最低消费：768p 4 秒是最便宜的合法请求，任何 MiniMax H3 任务都不会低于这个价。

EvoLink 价格$0.30

官方价$0.32

为你省下-5%

测试预算参考

根据预期测试次数选择充值金额。

充值积分

$10

约 33 次测试

适合首次验证。

$50

约 164 次测试

适合提示词与参考素材迭代。

$100

约 329 次测试

适合接入生产前的完整验证。

常见费用示例

短文生视频测试T2V 4 秒 768p

~$0.30-5%

20.672 cr~$0.32 官方价

完整时长视频T2V 15 秒 768p

~$1.14-5%

77.52 cr~$1.20 官方价

参考视频测试R2V 4 秒 + 3 秒参考 768p

~$0.53-5%

36.176 cr~$0.56 官方价

示例按你所在用户组的当前秒价计算。参考视频秒数与输出时长一并计费。

MiniMax H3 价格

模式	768P	2K	计费依据
文生视频标准路由	$0.076/s-5% 5.168 cr/s$0.080 官方价	$0.123/s-5% 8.398 cr/s$0.130 官方价	输出视频秒数
图生视频标准路由	$0.076/s-5% 5.168 cr/s$0.080 官方价	$0.123/s-5% 8.398 cr/s$0.130 官方价	输出视频秒数
参考视频图片或音频参考	$0.076/s-5% 5.168 cr/s$0.080 官方价	$0.123/s-5% 8.398 cr/s$0.130 官方价	输出视频秒数
参考视频视频参考	$0.076/s-5% 5.168 cr/s$0.080 官方价	$0.123/s-5% 8.398 cr/s$0.130 官方价	输出 + 参考视频秒数

文生视频

标准路由 · 输出视频秒数

768P $0.076/s · 5.168 cr/s $0.080/s-5%

2K $0.123/s · 8.398 cr/s $0.130/s-5%

图生视频

标准路由 · 输出视频秒数

768P $0.076/s · 5.168 cr/s $0.080/s-5%

2K $0.123/s · 8.398 cr/s $0.130/s-5%

参考视频

图片或音频参考 · 输出视频秒数

768P $0.076/s · 5.168 cr/s $0.080/s-5%

2K $0.123/s · 8.398 cr/s $0.130/s-5%

参考视频

视频参考 · 输出 + 参考视频秒数

768P $0.076/s · 5.168 cr/s $0.080/s-5%

2K $0.123/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 与积分余额。

输入

文本 / 首尾帧 / 参考素材

输出

2K / 768p 视频（MP4）

时长

4-15 秒

计费

按输出秒数

MiniMax H3 模型信息

以下是 EvoLink 已验证并对外提供的 API 请求规范。MiniMax 尚未公布的字段一律留空，不做推测。

模型类型

视频生成

MiniMax H3 属于 Hailuo 视频模型家族，不是 MiniMax M3 语言模型。

输入能力

文本、首尾帧、参考图 + 参考视频 + 参考音频

上游的帧输入与参考输入互斥，因此 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 可以用在哪些视频工作流

Hailuo 家族一贯被验证的那些真实场景，现在已经可以通过经过验证的路由直接调用。

文生视频创作

针对分镜、社交短视频和创意概念，评测提示词遵循、运镜、动作、物理合理性和可用输出率。

图生视频动画

支持首帧驱动、尾帧收束或首尾帧过渡，同时保持商品形状、角色身份、构图与视觉风格。

广告创意生产

评测批量吞吐、审核失败、重试、品牌一致性和每条通过广告的成本，而不是只看一条演示视频。

电商商品视频

在面向客户使用前，检查商品保真、可控运动、宽高比交付和 Logo 处理。

短剧与叙事内容

在连续镜头中比较角色一致性、镜头衔接和运镜指令，并用参考图、参考视频锚定风格。

多模型视频产品

把 MiniMax H3 作为一条路由与 Seedance、Kling、Wan 并行，并保留已测试的回退方案，避免绑定单一供应商。

在 Hailuo 视频生成器中体验这些工作流

MiniMax H3 值得加入你的视频模型栈吗？

按当前可验证的 API 请求规范做选择；当任务超出这些限制时，保留另一条可用路由。

适合优先测试的情况

需要生成 2K、4-15 秒的视频。
产品同时需要文生视频、首尾帧图生视频和参考素材生视频。
创作输入包含参考图片、视频或音频。
应用已经支持异步轮询或回调。
会在多个视频模型之间评估有效成片成本。

建议选择其他路线的情况

必须输出 4K 或超过 15 秒的视频。
任务必须同步返回，或提交后必须可以取消。
需要无声片段——H3 每条输出都带音频。
无法在结果链接生成后的 24 小时内保存 MP4。
需要开放权重或本地部署。

运行一次 4 秒测试

如何判断 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文生 + 图生

关键细节

三个 MiniMax H3 模型 ID

根据你提交的是提示词、首尾帧还是参考素材，分别使用 minimax-h3-text-to-video、minimax-h3-image-to-video 或 minimax-h3-reference-to-video。

严格参数白名单

只接受文档中列出的字段。seed、image_url、first_frame_image 等历史别名会返回 400 并指名该字段，而不是被静默忽略。

异步生产流程

提交任务、轮询状态或使用回调，再取回成品 MP4。不提供取消能力；失败、过期与被拒的任务全额退款。

为什么通过 EvoLink 接入 MiniMax H3 API

成本透明

生成前就能看到积分与秒价，参考视频秒数一并计入。

统一 API

在 Hailuo、Seedance、Kling 等视频路由之间切换，无需重建鉴权与计费。

统一余额

所有路由的积分、消耗与模型用量都在同一个控制台查看。

任务状态追踪

清楚看到任务处于排队、生成中、已完成还是失败，失败自动退款。

模型自由选择

把 MiniMax H3 作为一条已测试路由，需要时切换到其他家族。

Hailuo 模型家族

对比全部 Hailuo 模型

MiniMax H3

当前模型

下一代 Hailuo 路由：2K / 768p 输出、4-15 秒，支持文本、首尾帧与参考素材驱动。

Hailuo 2.3

MiniMax 目前公开并提供 API 文档的 Hailuo 视频模型，包含 Standard 与 Fast 路由，支持文生视频和图生视频。

查看

Hailuo 02

功能完整的上一代模型，支持文生、图生和首尾帧模式，可选 512p / 768p / 1080p。

查看

EvoLink 上的其他视频模型

Seedance 2.0

支持文本、图片、视频和音频参考工作流的多模态路由，提供 480p 至 4K 输出。

查看

Kling O3

具备多模态控制能力的生产视频路由，能力边界与成本结构不同。

查看

Wan 2.7

适用于文生视频和图生视频的备用路线，提供不同的时长与价格选项。

查看

采用 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 保存到你有权使用的存储中。

API 参考

选择端点

模型 ID

端点

身份验证

所有 API 均需要 Bearer Token 身份验证。

请求头

Authorization: 
Bearer YOUR_API_KEY

获取 API Key

POST

/v1/videos/generations

Create MiniMax H3 Text-to-Video

Generate 2K or 768p video from a text prompt with MiniMax H3. Omitting quality gives you 768p.

Strict parameter whitelist: any field outside the table below is rejected with HTTP 400 and the offending field name.

Asynchronous processing — poll the returned task ID or pass a callback URL.

请求参数

modelstringRequiredDefault: minimax-h3-text-to-video

Fixed value: minimax-h3-text-to-video

Exampleminimax-h3-text-to-video

promptstringRequired

Text description of the video to generate.

Notes

Up to 7000 characters
Media fields are rejected on this model — use the image-to-video or reference-to-video model instead

ExampleA lone traveler walks along a windswept cliff at golden hour, cinematic tracking shot

durationintegerOptionalDefault: 4

Output duration in seconds.

Value	Description
4-15	Any integer between 4 and 15

Notes

Decimals, numeric strings, and out-of-range values return 400 — no silent downgrade
Duration directly determines billing

Example5

qualitystringOptionalDefault: 768p

Output resolution.

Value	Description
768p	Default. Billed at 8/13 of the 2K rate
2k	Full-rate tier

Example2k

aspect_ratiostringOptionalDefault: 16:9

Output aspect ratio. Text-to-video requires an explicit ratio; adaptive is not accepted.

Value	Description
21:9	Ultrawide
16:9	Landscape (default)
4:3	Standard
1:1	Square
3:4	Portrait standard
9:16	Portrait

Example16:9

callback_urlstringOptional

HTTPS callback URL for task completion notification. Handled by EvoLink; never forwarded upstream.

Examplehttps://your-domain.com/webhooks/video-done

请求示例

{
  "model": "minimax-h3-text-to-video",
  "prompt": "A lone traveler walks along a windswept cliff at golden hour, cinematic tracking shot",
  "duration": 5,
  "quality": "2k",
  "aspect_ratio": "16:9"
}

响应示例

{
  "id": "task-unified-1785400000-abc123",
  "object": "video.generation.task",
  "created": 1785400000,
  "model": "minimax-h3-text-to-video",
  "status": "processing",
  "type": "video",
  "progress": 1,
  "task_info": {
    "estimated_time": 300,
    "can_cancel": false,
    "video_duration": 5
  },
  "usage": {
    "credits_reserved": 44.2,
    "billing_rule": "per_second",
    "user_group": "default"
  }
}