MiniMax H3

CAPABILITIES

能力与限制

支持模式

文生视频首帧尾帧首尾帧参考素材

使用前需了解

支持文字、首尾帧、参考图片或视频，按型号规则选用参考音频。字段与规格请以本人 /v1/models 为准。

规格与默认值
参数	支持值 / 默认
分辨率	768P / 2K
输出时长	4–15 秒
画幅	21:9 · 16:9 · 4:3 · 1:1 · 3:4 · 9:16 · adaptive
提示词限制	7000 Unicode 码点
定义默认值（以模式规则为准）	duration: 5 · resolution: 768P · aspect_ratio: 16:9
参考素材上限	9 图片 / 3 视频 / 3 音频

素材上限不表示所有模式可以组合使用。具体大小、格式与互斥规则见完整字段说明。

查看完整请求字段与限制（中文）↗

字段	字段含义	类型	是否必选	默认值	可选值 / 范围	备注说明（模式与素材限制）	模型专用特殊字段
`model`	调用型号的接口标识	string	是	无	minimax-h3	固定调用名称，按示例精确填写	否
`prompt`	描述内容、动作、镜头或编辑意图的提示词	string	是	无	去首尾空白后1～7000 Unicode码点	所有模式必填	否
`duration`	输出视频时长，单位秒	integer	否	5	4～15秒	不支持自动时长	否
`resolution`	输出视频分辨率	string	否	768P	768P / 2K	按本行可选值选择输出分辨率	否
`aspect_ratio`	输出画幅宽高比	string	否	文生16:9；素材adaptive	21:9 / 16:9 / 4:3 / 1:1 / 3:4 / 9:16 / adaptive	首尾帧省略或adaptive；参考模式可用具体比例或adaptive；文生adaptive按16:9处理	否
`first_frame_image`	约束视频开始画面的图片地址	string	首帧／首尾帧模式需提供；可用角色替代	无	HTTPS URL	首帧最多1张，与参考素材互斥；图片规格见image_with_roles[].url	否
`last_frame_image`	约束视频结束画面的图片地址	string	尾帧／首尾帧模式需提供；可用角色替代	无	HTTPS URL	尾帧最多1张，与参考素材互斥；图片规格见image_with_roles[].url	否
`image_with_roles`	明确指定图片用途的数组	object[]	否	无	每项 {url, role}	按role选择首帧、尾帧或参考模式；首尾帧与参考素材互斥，不重复首尾角色	否
`image_with_roles[].url`	数组内单张图片的地址	string	数组内是	无	HTTPS URL	所有图片字段统一要求：PNG / JPEG / WebP；单文件≤30MiB；宽、高均256～5760像素；宽高比0.4～2.5	否
`image_with_roles[].role`	数组内图片的用途	string	数组内是	无	first_frame / last_frame / reference_image	首尾角色各≤1张；reference_image与image_urls合计≤9张；两类模式互斥	否
`image_urls`	图片地址数组	string[]	否	无	参考图 HTTPS URL	一律参考图，与reference_image角色合计≤9张；参考模式须至少有图片或视频，音频不能单独输入	否
`video_urls`	参考视频地址数组	string[]	否	无	≤3段	MP4 / MOV；单文件≤50MiB；单段2～15秒；视频合计≤15秒；宽、高均256～5760像素；宽高比0.4～2.5；23.976～60fps	否
`audio_urls`	参考音频地址数组	string[]	否	无	≤3段	PCM WAV / MP3（含Xing/Info）；单文件≤15MiB；单段2～15秒；音频合计≤15秒；需搭配参考图片或视频	否
`watermark`	是否请求输出水印	boolean	否	false	true / false	输出AIGC水印	是 · H3 / H3 Max / Seedance / Wan
`nsfw_check`	额外审核选项，本版仅接受false	boolean	否	false	仅 false	true返回unsupported_parameter	是 · 除Vidu与Regeneration外的型号

目录展示已实现的适配能力，不代表所有型号或规格均向当前账户开放。实际启用状态、权限与默认值以本人 /v1/models 为准。

查看完整请求字段与限制（中文）↗

CREATIVE WORKFLOWS

适用场景

将文字分镜转成视频镜头。
使用首尾帧规划画面过渡。
以参考图片或视频延展创作。

概念视觉，非生成样片；本页尚无经过验证的模型实拍样例。

PRICING / USD

按所选规格计费。

售价为 USD。参考价格带采集日期；缺价不代表免费。历史任务仍按创建时的价格快照结算。

正在读取当前价格…

模型价格 ↗

API INTEGRATION

接入示例

在自己的服务端使用 HTTP 接入，选择模型与参数；先由服务方配置账户、Key 和逐模型权限。

202 表示已受理。保存任务编号，按 next_poll_after_seconds 查询；生成状态、产物可用性与费用状态分别判断。

HTTP / cURL

curl --request POST 'https://bytesota-api.businessmodelcraft.com/v1/videos/generations' \
  --header 'Authorization: Bearer YOUR_PLATFORM_API_KEY' \
  --header 'Content-Type: application/json' \
  --header 'Idempotency-Key: example-minimax-h3-text-001' \
  --data-raw '{
    "model": "minimax-h3",
    "prompt": "小猫沿花园小径向前走，镜头缓缓跟随。",
    "duration": 5,
    "resolution": "768P",
    "aspect_ratio": "16:9"
  }'

查询结果

HTTP / cURL

curl 'https://bytesota-api.businessmodelcraft.com/v1/tasks/vid_ABCDEFGHIJKLMNOP' \
  --header 'Authorization: Bearer YOUR_PLATFORM_API_KEY'

示例仅供复制，不会在网页中执行；凭证为占位符。

规格与示例来源：模型定义及公开 API 接入指南。

阅读完整 API 文档（中文）↗