跳转到内容
免费注册
MiniMax H3

MiniMax H3 视频 API:生成与成片再生成

用 BetterToken API Key 接入 MiniMax H3,按 Model ID 和操作选择字段、素材与生成方式。

你可以从文字、首尾帧或参考素材生成视频,也可以把符合条件的自有 768p H3 成片再生成到 2k。再生成只接收源任务 ID,不接收新的素材 URL。

先准备 BetterToken API Key。Base URL 为 https://bettertoken.ai/v1,认证使用 Authorization: Bearer YOUR_API_KEY。原样复制 Model ID,大小写必须一致。

下方每份 request.json 都使用同一流程:先报价,再确认创建、轮询与下载。报价不启动生成;创建会提交付费任务。当前费用见模型广场。

型号与操作

下表按操作列出可选值;字段默认值、素材数量和组合限制见对应小节。素材大小按 1 MB = 1048576 字节换算。

Model ID操作时长(秒)输出档位比例音频素材角色
MiniMax-H3image_to_video4–15,步长 1768p、2kadaptiveprovider_defaultfirst_frame、last_frame、reference_image、reference_video、reference_audio
MiniMax-H3reference_to_video4–15,步长 1768p、2kadaptive、21:9、16:9、4:3、1:1、3:4、9:16provider_defaultreference_image、reference_video、reference_audio
MiniMax-H3text_to_video4–15,步长 1768p、2k21:9、16:9、4:3、1:1、3:4、9:16provider_default无
MiniMax-H3video_edit继承源任务2kadaptive(继承)provider_default源任务 ID

provider_default 表示沿用模型的音频设置,不提供 on / off 开关。再生成的比例、时长与输入由源任务决定。

示例素材

图生与图片参考示例使用白色桌面上的蓝色陶瓷杯。你可以保留样图试用,也可以先替换为自己有权使用且符合本页限制的公网 HTTPS 素材。

视频生成参考图:白色桌面上的蓝色陶瓷杯

文生视频

MiniMax-H3

你只有文字描述时,使用本操作生成视频。

把 model 设为本小节的 Model ID,把 operation 设为 text_to_video。仅使用下表列出的生成字段;素材放在 media 数组中。

字段类型必填可选值或范围默认值
audio.modestring否provider_defaultprovider_default
duration.modestring否fixedfixed
duration.secondsinteger否4–15,步长 1 秒;仅固定时长使用4
output.aspect_ratiostring是21:9、16:9、4:3、1:1、3:4、9:16无
output.formatstring否mp4mp4
output.resolutionstring否768p、2k768p
promptstring是字符串无
watermarkboolean否false、truefalse

素材要求

本操作不接收素材。

组合约束

  • 使用 duration.mode="fixed" 时必须有 duration.seconds。显式填写 fixed 时请同时填写秒数。

请求示例

将下方 JSON 保存为 request.json,然后按通用流程先报价、确认后创建。

{
"model": "MiniMax-H3",
"operation": "text_to_video",
"prompt": "A blue ceramic mug on a white table. Slowly move the camera closer in soft daylight.",
"duration": {
"mode": "fixed",
"seconds": 5
},
"output": {
"resolution": "768p",
"aspect_ratio": "16:9"
}
}

常见 422 错误

422 错误码处理方法
enum / range / step按本节字段表调整取值与步长。
unsupported_field删除本操作字段表中没有的字段。
requires按本节组合约束补齐秒数、比例、音频设置或素材。

图生视频

MiniMax-H3

你希望以图片确定起始画面或首尾画面时,使用本操作。

把 model 设为本小节的 Model ID,把 operation 设为 image_to_video。仅使用下表列出的生成字段;素材放在 media 数组中。

字段类型必填可选值或范围默认值
audio.modestring否provider_defaultprovider_default
duration.modestring否fixedfixed
duration.secondsinteger否4–15,步长 1 秒;仅固定时长使用4
output.aspect_ratiostring否adaptiveadaptive
output.formatstring否mp4mp4
output.resolutionstring否768p、2k768p
promptstring是字符串无
watermarkboolean否false、truefalse

素材要求

素材角色类型与数量格式单文件限制
first_frameimage,可选,最多 1 个jpg、jpeg、png、webp、heic、heif大小不超过 30 MB;宽 256–5760 px;高 256–5760 px
last_frameimage,可选,最多 1 个jpg、jpeg、png、webp、heic、heif大小不超过 30 MB;宽 256–5760 px;高 256–5760 px
reference_imageimage,可选,最多 9 个jpg、jpeg、png、webp、heic、heif大小不超过 30 MB;宽 256–5760 px;高 256–5760 px
reference_videovideo,可选,最多 3 个mp4、mov大小不超过 50 MB;宽 256–5760 px;高 256–5760 px;时长 2–15 秒;帧率不低于 23.976 fps,且不超过 60 fps;本角色合计不超过 15 秒
reference_audioaudio,可选,最多 3 个wav、mp3大小不超过 15 MB;时长 2–15 秒;本角色合计不超过 15 秒

素材是否必需还需满足下方组合约束。

组合约束

  • 使用 duration.mode="fixed" 时必须有 duration.seconds。显式填写 fixed 时请同时填写秒数。
  • 至少提供以下角色之一:first_frame、last_frame。
  • 首尾帧不能与参考图片、参考视频或参考音频混用。首尾帧使用图生操作,参考素材使用参考生成操作。

请求示例

将下方 JSON 保存为 request.json,然后按通用流程先报价、确认后创建。

{
"model": "MiniMax-H3",
"operation": "image_to_video",
"prompt": "Slowly move the camera closer to the blue ceramic mug. Preserve its shape and the white table.",
"duration": {
"mode": "fixed",
"seconds": 5
},
"output": {
"resolution": "768p",
"aspect_ratio": "adaptive"
},
"media": [
{
"id": "first",
"type": "image",
"role": "first_frame",
"source": "https://docs.bettertoken.ai/images/nano-banana-guide/sample-07.png"
}
]
}

常见 422 错误

422 错误码处理方法
enum / range / step按本节字段表调整取值与步长。
unsupported_field删除本操作字段表中没有的字段。
requires按本节组合约束补齐秒数、比例、音频设置或素材。
mutually_exclusive_roles分开使用首尾帧和参考素材。
count / media_role按本节素材表调整角色与数量。
video_input_unsupported检查公网 HTTPS 地址、Content-Type 与文件格式,再重新报价。

参考生成

MiniMax-H3

你希望用参考素材保持主体或动作特征时,使用本操作。

把 model 设为本小节的 Model ID,把 operation 设为 reference_to_video。仅使用下表列出的生成字段;素材放在 media 数组中。

字段类型必填可选值或范围默认值
audio.modestring否provider_defaultprovider_default
duration.modestring否fixedfixed
duration.secondsinteger否4–15,步长 1 秒;仅固定时长使用4
output.aspect_ratiostring否adaptive、21:9、16:9、4:3、1:1、3:4、9:16adaptive
output.formatstring否mp4mp4
output.resolutionstring否768p、2k768p
promptstring是字符串无
watermarkboolean否false、truefalse

素材要求

素材角色类型与数量格式单文件限制
reference_imageimage,可选,最多 9 个jpg、jpeg、png、webp、heic、heif大小不超过 30 MB;宽 256–5760 px;高 256–5760 px
reference_videovideo,可选,最多 3 个mp4、mov大小不超过 50 MB;宽 256–5760 px;高 256–5760 px;时长 2–15 秒;帧率不低于 23.976 fps,且不超过 60 fps;本角色合计不超过 15 秒
reference_audioaudio,可选,最多 3 个wav、mp3大小不超过 15 MB;时长 2–15 秒;本角色合计不超过 15 秒

素材是否必需还需满足下方组合约束。

组合约束

  • 使用 duration.mode="fixed" 时必须有 duration.seconds。显式填写 fixed 时请同时填写秒数。
  • 至少提供以下角色之一:reference_image、reference_video、reference_audio。
  • 首尾帧不能与参考图片、参考视频或参考音频混用。首尾帧使用图生操作,参考素材使用参考生成操作。

请求示例

将下方 JSON 保存为 request.json,然后按通用流程先报价、确认后创建。

{
"model": "MiniMax-H3",
"operation": "reference_to_video",
"prompt": "Create a product video of the blue ceramic mug in the reference image. Keep its shape and color.",
"duration": {
"mode": "fixed",
"seconds": 5
},
"output": {
"resolution": "768p",
"aspect_ratio": "adaptive"
},
"media": [
{
"id": "reference",
"type": "image",
"role": "reference_image",
"source": "https://docs.bettertoken.ai/images/nano-banana-guide/sample-07.png"
}
]
}

常见 422 错误

422 错误码处理方法
enum / range / step按本节字段表调整取值与步长。
unsupported_field删除本操作字段表中没有的字段。
requires按本节组合约束补齐秒数、比例、音频设置或素材。
mutually_exclusive_roles分开使用首尾帧和参考素材。
count / media_role按本节素材表调整角色与数量。
video_input_unsupported检查公网 HTTPS 地址、Content-Type 与文件格式,再重新报价。

成片再生成

MiniMax-H3

你已有自己的 768p H3 成片,并希望按原内容再生成到 2k 时,使用此操作。它不接受任意视频文件。

源任务必须同时满足:

  • 属于你的账号,Model ID 为 MiniMax-H3。
  • 生成已成功,成片仍可下载。
  • 输出设置为 768p。
  • 从源任务创建时算起不超过 7 天。

服务器还会检查源视频格式;不符合条件时返回 422 video_regeneration_source_invalid。用源任务 ID 报价,不要自行改写视频文件来代替源任务。

请求字段类型必填取值
modelstring是MiniMax-H3
operationstring是video_edit
provider_options.hailuo.source_task_idstring是你的符合条件的源任务 ID
watermarkboolean否false / true,默认 false

不要传 prompt、duration、output、audio 或 media。再生成会继承源任务内容与输入,输出为 2k、adaptive、MP4。

先把 REPLACE_WITH_YOUR_H3_TASK_ID 替换为自己的源任务 ID,再报价与创建。 这会创建新的付费任务,请使用新的状态文件。

{
"model": "MiniMax-H3",
"operation": "video_edit",
"provider_options": {
"hailuo": {
"source_task_id": "REPLACE_WITH_YOUR_H3_TASK_ID"
}
}
}

源任务不符合条件或不存在时,报价返回 422 video_regeneration_source_invalid,field_path 为 provider_options.hailuo.source_task_id。下例用于识别该错误,不能用于生成:

{
"model": "MiniMax-H3",
"operation": "video_edit",
"provider_options": {
"hailuo": {
"source_task_id": "video_DOES_NOT_EXIST"
}
}
}

官方资料

调用 BetterToken 时,使用本页字段与实时模型目录中的对应操作。