MiniMax H3 Max Turbo API

Half-price, faster MiniMax H3 Max: 5–15 s clips with first/last frame and a driving soundtrack.

MiniMax·视频可用

低至$0.015/ 秒$0.016省 10%

模型 IDminimax-h3-max-turbo

text-to-videoimage-to-videofast

输入

文本 · 图片 · 音频

输出

视频

供应商

2 家供应商

Duration (s)

5 – 15

Resolution

480p · 768p · 1080p

Aspect ratio

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

MiniMax H3 Max Turbo 价格

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

支持的模式
文生视频
标准
低至 $0.015 / 秒
2 家供应商
图生视频
首帧 / 尾帧
低至 $0.015 / 秒
2 家供应商
规格480p768p1080p
文生视频
标准
$0.015 / 秒
2 积分$0.016省 10%
$0.023 / 秒
3 积分$0.026省 10%
$0.047 / 秒
5 积分$0.052省 10%
图生视频
首帧 / 尾帧
$0.015 / 秒
2 积分$0.016省 10%
$0.023 / 秒
3 积分$0.026省 10%
$0.047 / 秒
5 积分$0.052省 10%

接入前先试用 MiniMax H3 Max Turbo

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

供应商
视频
预计费用$0.13省 10%12 积分$0.1170

输入

prompt
audio_url
duration
resolution
aspect_ratio

费用按当前价格目录预估,提交时重新核价。自动路由的实际渠道可能不同;按用量计费的任务完成后结算。

结果

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

本次请求的各供应商预估费用

MiniMax H3 Max Turbo 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-turbo",
  "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-turbo"
providerstring否指定供应商;不传则自动路由到最便宜的。可选: fal | atlascloud
inputobject是模型参数,字段见下方 input 字段表。
callback_urlstring否可选的公开 HTTPS 回调地址,接收带签名的任务最终结果;仍可通过查询接口获取状态。

input · input 字段

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

参数名类型必填可选值默认值
prompt*string是——
image_url
Optional start image (image-to-video)
string否——
end_image_urlstring否——
audio_url
Audio the video follows (2–15 s)
string否——
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-turbo",
  "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-turbo",
  "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-turbo
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"

报价

报价分为接口报价和前端报价:接口报价由服务端返回当前可用渠道的费用;前端报价读取 models 的价格与计费字段,在用户修改参数时本地计算。

curl "https://01router.com/api/v1/quote" -H "Content-Type: application/json" --data-binary @- <<'JSON'
{
  "model": "minimax-h3-max-turbo",
  "input": {
    "prompt": "A cinematic shot of a red fox running through snow",
    "duration": 5,
    "resolution": "768p",
    "aspect_ratio": "16:9"
  }
}
JSON

提示词 API

公开只读接口,无需 API Key,不扣除积分。复用提示词库中已启用模型的已发布示例,支持按模型、来源和场景组合筛选。

curl "https://01router.com/api/v1/prompts?model=minimax-h3-max-turbo&locale=en&page=1"
curl "https://01router.com/api/v1/prompts/PROMPT_ID?locale=en"

使用返回的 modelSlug 和 prompt 构造下方请求体,调用 POST /generations;生成接口仍需 API Key,并按模型计费。其他生成参数请通过 GET /models/minimax-h3-max-turbo 查询后补充。

模型信息与参数

此公开接口返回模型参数,以及各供应商支持的参数约束和价格。

curl "https://01router.com/api/v1/models/minimax-h3-max-turbo"

错误码

结合 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 Turbo 与同类模型对比

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

MiniMax H3 Max TurboMiniMax H3 MaxMiniMax H3Grok Imagine Video 1.5
厂商MiniMaxMiniMaxMiniMaxxAI
起步价$0.015 / 秒$0.029 / 秒$0.036 / 秒$0.011 / 秒
输入文本 · 图片 · 音频文本 · 图片 · 音频文本 · 图片 · 视频 · 音频文本 · 图片
供应商2 家供应商6 家供应商8 家供应商10 家供应商
Duration (s)5 – 155 – 155 – 151 – 15
Resolution480p · 768p · 1080p480p · 768p · 1080p768p · 2k480p · 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 · 9:16 · 1:1 · 4:3 · 3:4 · 21:916:9 · 4:3 · 3:2 · 1:1 · 2:3 · 3:4 · 9:16

相关模型

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