MiniMax H3 Max API

MiniMax H3 post-trained by fal for speed: 5–15 s clips with first/last frame, ranked #1 on video arenas.

MiniMax·视频可用

低至$0.029/ 秒$0.033省 10%

模型 IDminimax-h3-max

text-to-videoimage-to-video

输入

文本 · 图片

输出

视频

供应商

6 家供应商

Duration (s)

5 – 15

Resolution

480p · 768p · 1080p

Aspect ratio

16:9 · 9:16 · 1:1 · 4:3 · 3:4 · 21:9

近 7 天表现 · 近期请求较少,暂无统计数据。

MiniMax H3 Max 价格

价格按单位计费;未指定供应商时,会路由到支持该参数组合且价格最低的供应商。

规格480p768p1080p
全部规格
$0.029 / 秒
3 积分
$0.047 / 秒
5 积分
$0.094 / 秒
10 积分

接入前先试用 MiniMax H3 Max

写代码之前,先测试生成效果、对比各供应商价格并预估费用。

供应商
视频
预计费用

输入

prompt
image_url
end_image_url
duration
resolution
aspect_ratio

结果

空闲
生成结果会显示在这里。

本次请求的各供应商报价

输入提示词即可对比各供应商价格。

MiniMax H3 Max 提示词示例

可直接使用的提示词,一键载入 Playground 再调整。

来源
场景分类

共 14 条提示词

An aging warrior-monk in scorched ceremonial armor, a split ceramic mask and a humming prayer-band on his forearm + 0–4s: climbs silently along a cliffside terrace as insect-like surveyor drones comb the sun-bleached ruins, standing alone under as the camera rises over the ruined monastery. Sun-blasted post-apocalyptic sci-fi action, dust, heat haze, practical debris, sweeping crane tracking, silence broken only by wind.

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.

BLACK MIRROR TIDEFLATS / THE COLLAPSING SEA-CATHEDRAL Style: 8K cinematic. Photorealistic — no 3D render, no game engine, no game-cutscene aesthetic. Cinematography: naturalistic master cinematography. Lighting: high-contrast dramatic light. Cold storm-blue dusk across the flats vs. blinding sodium-orange furnace glow pouring from the toppling structure. The wet mirror surface doubles every light source into a second inverted world. Color: 60:30:10 — dominant gunmetal blue and wet slate (the tideflats and sky) / secondary sodium amber and rust-red (burning floodlights, corroded steel) / accent magnesium white and cobalt blue (the failing reactor core and its arc-flashes). Camera: physical cine lens. 180° shutter motion blur. Continuous handheld operator shake, motivated by the ground concussions rolling through the shallow water. Physics: gravity and inertia respected. Steel trusses buckle and fold under their own mass; spray, ash and salt mist obey atmospheric drag. SUBJECTS: @pilot: a lone figure in a salt-crusted pressure suit crewing a skeletal wind-skiff — a low wheeled land-yacht with a torn carbon sail — hunched at the tiller, cracked gold-tinted visor reflecting the falling structure, throwing twin walls of white spray from its outriggers. @cathedral: a colossal derelict sea-rig, a kilometre of rusted iron lattice and floodlight towers, listing and buckling as it collapses into the shallows, shedding burning platform decks and cobalt arc-flash from its ruptured core. LOCATION: an endless tidal flat of black volcanic glass under two inches of standing water — a perfect mirror to the horizon — broken by rotting mooring pylons and drifting curtains of salt mist, the skyline dominated by the burning collapse. ACTION — ONE CONTINUOUS TAKE, single unbroken handheld tracking shot, NO cuts, 15 seconds. 0:00–0:05 Medium-Wide on @pilot: camera tracks alongside the skiff as it carves between rotting pylons that burst into splinters and spray behind the wheels; the horizon tears open as @cathedral enters frame, leaning, trailing burning deck plates. 0:05–0:10 continuous zoom-in / tilt up: camera glides past the skiff and tilts up through the pylons onto the collapse; a core vessel detonates, the shockwave ripping the standing water into a flat sheet and bending the flare into a horizontal streak across frame. 0:10–0:15 Extreme Close-Up on @cathedral: telephoto-compressed view of the disintegrating rig against the sky, steel plate peeling and glowing white-hot, raining burning debris down toward the camera. CONSTRAINTS: 16:9 anamorphic widescreen. ONE CONTINUOUS SHOT — absolutely NO hard cuts. Telephoto compression during the zoom. No slow-motion. Photoreal throughout. AUDIO (NO MUSIC): deep structural groan of failing steel, the hiss and slap of water under the hull, tearing-metal screech from above, the rigging-hum and canvas crack of the skiff at speed, wind roar across open flats.

He explodes upward out of the black. Both arms drive toward the falling apple, body twisting, white linen sleeves snapping taut then bunching as his shoulders roll. The apple tumbles fast, end over end, its stem whipping. He mistimes it — the fruit glances off his fingertips and spins away; he lunges after it, throwing his weight sideways, hair swinging across his face, eyes flashing wide. He catches it hard against his palm, the impact shoving his arm back and down, linen collapsing in loose folds. He pulls it in against his chest, breathing hard, and breaks into a grin as he looks straight into the lens. The candlelight jumps with every movement, flaring across his forearms and guttering into darkness behind him.

Create a 5-second live-action Hollywood film shot in a bright university library. A thoughtful professor stands in a medium shot, turns slightly toward an unseen student, and calmly says, “What is the real?” Natural daylight, professional cinema camera, realistic performance, subtle camera drift, no close-up, no dark lighting, perfect lip sync.

Exactly 5 seconds. Inside a bright sterile laboratory, a cryogenic chamber opens and cold vapor spills across the floor. A confused man slowly sits up. A scientist steps forward and says, “Welcome back.” The man asks, “What year is it?” The scientist hesitates as the camera gently pulls backward. Photorealistic Hollywood science-fiction drama, soft white daylight, realistic vapor, restrained acting, accurate lip sync, no extreme close-up.

MiniMax H3 Max API 文档

该模型的接口、请求字段与可直接运行的调用示例。

Base URL

https://01router.com/api/v1
llms.txt

快速开始

将 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-max",
  "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
获取 API Key

输入参数

使用 Content-Type: application/json 发送请求。模型参数放在 input 中,model、provider、callback_url 放在最外层。

请求体

参数名类型必填说明
modelstring是"minimax-h3-max"
providerstring否指定供应商;不传则自动路由到最便宜的。可选: fal | 01router | apimart | evolink | atlascloud | vercel
inputobject是模型参数,字段见下方 input 字段表。
callback_urlstring否可选的公开 HTTPS 回调地址,接收带签名的任务最终结果;仍可通过查询接口获取状态。

input · input 字段

必填字段已明确标记,其他字段省略时使用所列默认值。

参数名类型必填可选值默认值
prompt*string是——
image_url
Optional start image (image-to-video)
string否——
end_image_urlstring否——
durationinteger否min: 5 · max: 155
resolutionstring否480p | 768p | 1080p768p
aspect_ratiostring否16:9 | 9:16 | 1:1 | 4:3 | 3:4 | 21:916:9
任务回调 →

输出结果

创建任务成功不代表生成完成。保存 id,查询到 succeeded 或 failed 后,读取 outputs 或 error。示例金额仅作说明,实际费用由请求决定。

queued→processing→succeeded / failed

提交后的响应

{
  "id": "gen_example",
  "object": "generation",
  "model": "minimax-h3-max",
  "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-max",
  "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"
}

响应字段

参数名类型必填说明
idstring是任务 ID,用于查询或取消任务。
objectstring是generation
modelstring是minimax-h3-max
typestring是video
providerstring是供应商
statusstring是queued → processing → succeeded / failed。进入任一终态后停止轮询。
inputobject是模型参数,字段见下方 input 字段表。
outputsstring[]是结果文件 URL 数组。处理中为空;成功后读取并及时下载保存。
errorstring | null是失败原因;无错误时为 null。
creditsnumber是本次请求扣除的积分。
price_usdnumber是本次请求的美元价格。
created_atstring是ISO 8601 格式的任务创建时间。
completed_atstring | 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-max",
  "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-max"

错误码

结合 HTTP 状态码和 error.message 排查。参数或认证错误需修正后再重试;生成任务失败则通过任务本身的 status 和 error 返回。

{
  "error": {
    "message": "Invalid or missing API key",
    "code": "unauthorized"
  }
}

400请求体或参数取值不合法

401缺少或无效的 API Key

402积分不足

404模型或任务不存在

409任务无法取消(已结束,或该供应商不支持取消)

429请求过于频繁,请稍后重试

502所有供应商都拒绝了任务(积分已退回)

鉴权、路由、计费与错误码详见 →

交给 AI 使用

将本模型文档交给编程助手:纯文本包含接口、输入约束、输出字段和请求示例。

打开 llms.txt

MiniMax H3 Max 与同类模型对比

并排对比规格与起步价,选择前建议用同一提示词实测。

MiniMax H3 MaxMiniMax H3Grok Imagine Video 1.5Seedance 2.5
厂商MiniMaxMiniMaxxAIByteDance
起步价$0.029 / 秒$0.036 / 秒$0.011 / 秒$0.086 / 秒
输入文本 · 图片文本 · 图片文本 · 图片文本 · 图片
供应商6 家供应商7 家供应商10 家供应商9 家供应商
Duration (s)5 – 155 – 151 – 154 – 30
Resolution480p · 768p · 1080p768p · 2k480p · 720p · 1080p480p · 720p · 1080p
Aspect ratio16:9 · 9:16 · 1:1 · 4:3 · 3:4 · 21:916:9 · 9:16 · 1:1 · 4:3 · 3:4 · 21:916:9 · 4:3 · 3:2 · 1:1 · 2:3 · 3:4 · 9:1616:9 · 9:16 · 1:1 · 4:3 · 3:4 · 21:9

MiniMax H3 Max API 常见问题

MiniMax H3 Max 擅长什么?

快速生成高质量短片,人物表演细腻,能按时间节拍控制动作。把动作按秒写(0-1 秒、1-2 秒……)可以精确控制画面。

支持哪些分辨率和时长?

5 到 15 秒,480p、768p 或 1080p。需要 2K 请用 MiniMax H3。

可以设置首帧和尾帧吗?

可以。image_url 作为首帧,可选的 end_image_url 作为尾帧。

生成速度如何?

H3 Max 是最快的视频模型之一,768p 短片常常几秒内完成,较长片段也远不到一分钟。

在 01router 上怎么计费?

按输出秒数和分辨率计费,详见价格表。生成失败会退还积分。

相关模型

同一个 API Key 即可调用的其他模型。