A young woman in a long pale coat walks toward a small stone chapel on a windswept cliff above the ocean. The opening frame is a cinematic long-lens medium-wide shot with tall coastal grass softly blurred in the foreground. She is illuminated by a break in the clouds while the chapel and dark ocean remain slightly subdued behind her. She stops halfway along the path when the chapel bell rings once. A man appears briefly in the doorway, then steps back into darkness. The camera slowly tracks through the foreground grass, keeping her centered in the moving composition, then gently pushes toward the chapel. Poetic romantic mystery, dramatic coastal light, strong depth separation, natural wind, restrained acting, cinematic European drama aesthetic.
MiniMax H3 API
MiniMax Hailuo H3 with native 768p and 2K output, 4–15 s, first/last frame.
低至$0.036/ 秒$0.04省 10%
模型 IDminimax-h3
输入
文本 · 图片
输出
视频
供应商
7 家供应商
Duration (s)
5 – 15
Resolution
768p · 2k
Aspect ratio
16:9 · 9:16 · 1:1 · 4:3 · 3:4 · 21:9
近 7 天表现 · 近期请求较少,暂无统计数据。
MiniMax H3 价格
价格按单位计费;未指定供应商时,会路由到支持该参数组合且价格最低的供应商。
| 规格 | 768p | 2k |
|---|---|---|
| 全部规格 | $0.054 / 秒 6 积分 | $0.117 / 秒 12 积分 |
接入前先试用 MiniMax H3
写代码之前,先测试生成效果、对比各供应商价格并预估费用。
输入
结果
空闲本次请求的各供应商报价
输入提示词即可对比各供应商价格。
MiniMax H3 提示词示例
可直接使用的提示词,一键载入 Playground 再调整。
共 10 条提示词
Speeder chase across a cliff city (single continuous shot) From a monumental cliffside city carved into stone, the camera dives toward a tiny streak of light ripping along a narrow ledge-road. Lock-on: a speeder hugging the wall at insane speed. The camera slingshots ahead, whips back, then drops tight to the rear thrusters: heat haze, grit snapping off the ledge, warning lights flashing. A collapsing balcony rains debris; the rider snaps a last-inch swerve under a falling arch, then threads through hanging laundry lines and open windows in one fluid line. The camera darts through the same openings, staying glued to the motion. One final bend and sudden calm: the camera blasts outward into a reveal of the city opening onto a boundless waterfall-fed valley, mist turning into rainbow.
the car revs through the desert
Two adult fantasy warriors in a stylized choreographed duel on a rain-slicked rooftop at night. One channels crackling blue-white energy, the other radiant orange light. They close the distance at high speed, exchanging blocks, parries, and glancing sweeps of glowing energy blades, then meet in a mid-air clash that bursts into colored sparks, light trails, and scattering rain. Sweeping camera, dramatic close-ups on hands and faces, exaggerated stylized motion, vibrant rim lighting, high contrast, ending on a heroic standoff pose. Non-violent stylized action, no blood, no injury, no gore, no weapons contact with bodies. Original character designs.
Cinematic wide shot at golden hour: a lone red-sailed boat glides across a mirror-still alpine lake, snow-capped mountains reflected in the water, soft mist drifting over the surface, warm sunlight breaking through clouds, slow camera dolly forward, rich color, high detail
A high-energy anime fight scene between two original warriors on a rain-soaked rooftop at night. One fighter glows with electric blue energy, the other with fiery red-orange power. They dash toward each other at extreme speed, exchange precise punches and sword strikes, then collide in a massive mid-air impact that sends colorful sparks, energy trails and shattered debris across the scene. Dynamic sweeping camera movement, dramatic close-ups, exaggerated anime motion, detailed character animation, vibrant lighting, strong contrast and a powerful cinematic final pose. No dialogue or text.
MiniMax H3 API 文档
该模型的接口、请求字段与可直接运行的调用示例。
Base URL
https://01router.com/api/v1快速开始
将 API_KEY 设为项目密钥,在服务端运行示例。示例中的媒体地址需替换为您自己的公开地址。
自动路由会选择支持当前请求的供应商。选择指定供应商,可查看它的参数约束和调用示例。
curl https://01router.com/api/v1/generations \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
--data-binary @- <<'JSON'
{
"model": "minimax-h3",
"input": {
"prompt": "A cinematic shot of a red fox running through snow",
"duration": 5,
"resolution": "768p",
"aspect_ratio": "16:9"
}
}
JSON
# Replace GENERATION_ID with the id returned above; poll until status is "succeeded" or "failed"
curl https://01router.com/api/v1/generations/GENERATION_ID -H "Authorization: Bearer $API_KEY"接口列表
这里只列出当前模型相关的接口,路径已包含 /api/v1。点击接口可跳转到使用说明。
鉴权
以 Bearer Token 方式发送 API Key,费用从 Key 所属账户的积分中扣除。
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json输入参数
使用 Content-Type: application/json 发送请求。模型参数放在 input 中,model、provider、callback_url 放在最外层。
请求体
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| model | string | 是 | "minimax-h3" |
| provider | string | 否 | 指定供应商;不传则自动路由到最便宜的。可选: fal | 01router | replicate | wavespeed | kie | apimart | vercel |
| input | object | 是 | 模型参数,字段见下方 input 字段表。 |
| callback_url | string | 否 | 可选的公开 HTTPS 回调地址,接收带签名的任务最终结果;仍可通过查询接口获取状态。 |
input · input 字段
必填字段已明确标记,其他字段省略时使用所列默认值。
| 参数名 | 类型 | 必填 | 可选值 | 默认值 |
|---|---|---|---|---|
| prompt* | string | 是 | — | — |
| image_url Optional start image (image-to-video) | string | 否 | — | — |
| end_image_url | string | 否 | — | — |
| duration | integer | 否 | min: 5 · max: 15 | 5 |
| resolution | string | 否 | 768p | 2k | 768p |
| aspect_ratio | string | 否 | 16:9 | 9:16 | 1:1 | 4:3 | 3:4 | 21:9 | 16:9 |
输出结果
创建任务成功不代表生成完成。保存 id,查询到 succeeded 或 failed 后,读取 outputs 或 error。示例金额仅作说明,实际费用由请求决定。
提交后的响应
{
"id": "gen_example",
"object": "generation",
"model": "minimax-h3",
"type": "video",
"provider": "fal",
"status": "processing",
"input": {
"prompt": "A cinematic shot of a red fox running through snow",
"duration": 5,
"resolution": "768p",
"aspect_ratio": "16:9"
},
"outputs": [],
"error": null,
"credits": 0,
"price_usd": 0,
"created_at": "2026-10-25T08:00:00.000Z",
"completed_at": null
}完成后的响应
{
"id": "gen_example",
"object": "generation",
"model": "minimax-h3",
"type": "video",
"provider": "fal",
"status": "succeeded",
"input": {
"prompt": "A cinematic shot of a red fox running through snow",
"duration": 5,
"resolution": "768p",
"aspect_ratio": "16:9"
},
"outputs": [
"https://example.com/output.mp4"
],
"error": null,
"credits": 0,
"price_usd": 0,
"created_at": "2026-10-25T08:00:00.000Z",
"completed_at": "2026-10-25T08:01:00.000Z"
}响应字段
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| id | string | 是 | 任务 ID,用于查询或取消任务。 |
| object | string | 是 | generation |
| model | string | 是 | minimax-h3 |
| type | string | 是 | video |
| provider | string | 是 | 供应商 |
| status | string | 是 | queued → processing → succeeded / failed。进入任一终态后停止轮询。 |
| input | object | 是 | 模型参数,字段见下方 input 字段表。 |
| outputs | string[] | 是 | 结果文件 URL 数组。处理中为空;成功后读取并及时下载保存。 |
| error | string | null | 是 | 失败原因;无错误时为 null。 |
| credits | number | 是 | 本次请求扣除的积分。 |
| price_usd | number | 是 | 本次请求的美元价格。 |
| created_at | string | 是 | ISO 8601 格式的任务创建时间。 |
| completed_at | string | null | 是 | ISO 8601 格式的完成时间;未完成时为 null。 |
获取结果
每隔几秒轮询,直到 status 为 succeeded 或 failed。输出链接由供应商托管,可能过期,请及时下载保存;也可以传 callback_url 接收推送。
curl "https://01router.com/api/v1/generations/GENERATION_ID" \
-H "Authorization: Bearer $API_KEY"queued → processing → succeeded / failed。进入任一终态后停止轮询。 结果文件 URL 数组。处理中为空;成功后读取并及时下载保存。
取消任务
取消取决于供应商支持情况和任务状态。确认取消后返回 status: failed、error: Canceled by user;不支持取消或已完成的任务返回 409 not_cancelable。
curl -X POST "https://01router.com/api/v1/generations/GENERATION_ID/cancel" \
-H "Authorization: Bearer $API_KEY"报价
请求体与创建任务相同。返回按价格排序的可用供应商,以及无法处理该请求的供应商及原因。
curl "https://01router.com/api/v1/quote" -H "Content-Type: application/json" --data-binary @- <<'JSON'
{
"model": "minimax-h3",
"input": {
"prompt": "A cinematic shot of a red fox running through snow",
"duration": 5,
"resolution": "768p",
"aspect_ratio": "16:9"
}
}
JSON模型信息与参数
此公开接口返回模型参数,以及各供应商支持的参数约束和价格。
curl "https://01router.com/api/v1/models/minimax-h3"错误码
结合 HTTP 状态码和 error.message 排查。参数或认证错误需修正后再重试;生成任务失败则通过任务本身的 status 和 error 返回。
{
"error": {
"message": "Invalid or missing API key",
"code": "unauthorized"
}
}400请求体或参数取值不合法
401缺少或无效的 API Key
402积分不足
404模型或任务不存在
409任务无法取消(已结束,或该供应商不支持取消)
429请求过于频繁,请稍后重试
502所有供应商都拒绝了任务(积分已退回)
交给 AI 使用
将本模型文档交给编程助手:纯文本包含接口、输入约束、输出字段和请求示例。
MiniMax H3 与同类模型对比
并排对比规格与起步价,选择前建议用同一提示词实测。
| MiniMax H3 | MiniMax H3 Max | Grok Imagine Video 1.5 | Seedance 2.5 | |
|---|---|---|---|---|
| 厂商 | MiniMax | MiniMax | xAI | ByteDance |
| 起步价 | $0.036 / 秒 | $0.029 / 秒 | $0.011 / 秒 | $0.086 / 秒 |
| 输入 | 文本 · 图片 | 文本 · 图片 | 文本 · 图片 | 文本 · 图片 |
| 供应商 | 7 家供应商 | 6 家供应商 | 10 家供应商 | 9 家供应商 |
| Duration (s) | 5 – 15 | 5 – 15 | 1 – 15 | 4 – 30 |
| Resolution | 768p · 2k | 480p · 768p · 1080p | 480p · 720p · 1080p | 480p · 720p · 1080p |
| Aspect ratio | 16:9 · 9:16 · 1:1 · 4:3 · 3:4 · 21:9 | 16:9 · 9:16 · 1:1 · 4:3 · 3:4 · 21:9 | 16:9 · 4:3 · 3:2 · 1:1 · 2:3 · 3:4 · 9:16 | 16:9 · 9:16 · 1:1 · 4:3 · 3:4 · 21:9 |
MiniMax H3 API 常见问题
MiniMax H3 就是海螺 03 吗?
是的,MiniMax H3 也叫海螺 03(Hailuo 03),主打原生音频、多镜头叙事和清晰的 2K 画面。
支持哪些分辨率?
768p 和 2K。草稿用 768p,成片用 2K。
支持哪些时长和输入?
5 到 15 秒,可以是纯文字、首帧图片,或首尾帧(image_url 和 end_image_url)。
和 H3 Max 有什么区别?
H3 支持 2K、叙事能力更强,但渲染较慢(通常 1 到 3 分钟);H3 Max 快得多,最高 1080p。
在 01router 上怎么计费?
按输出秒数计费,2K 比 768p 贵,详见价格表。生成失败会退还积分。
相关模型
同一个 API Key 即可调用的其他模型。
MiniMax H3 Max
MiniMax H3 post-trained by fal for speed: 5–15 s clips with first/last frame, ranked #1 on video arenas.
Grok Imagine Video 1.5
Grok Imagine Video 1.5: 1–15 second videos with synchronized audio, at 480p, 720p or 1080p. Image-to-video follows the source image aspect ratio.
Seedance 2.5
ByteDance’s flagship video model: up to 30 s in one pass, native synchronized audio, first/last-frame control.
Grok Imagine Video 1.5 Lite
Grok Imagine Video 1.5 Lite: 1–15 second videos with synchronized audio, at 480p, 720p or 1080p. Image-to-video follows the source image aspect ratio.
Seedance 2.0
Multi-shot Seedance generation with synchronized audio and first/last-frame control, 4–15 s.
Seedance 2.0 Mini
Faster, lower-cost Seedance 2.0 for drafts and high-volume generation (480p/720p).