Skip to main content
POST

认证

string
必填
所有接口均需要使用 Bearer Token 进行认证获取 API Key:访问 API Key 管理页面 获取您的 API Key使用时在请求头中添加:

生成模式

MiniMax-H3 通过请求字段自动路由到对应模式,无需指定 mode 字段
严格互斥:图生视频字段(first_frame_image / last_frame_image,以及 image_with_roles 中的 first_frame / last_frame)与多模态参考字段(image_urlsvideo_urlsaudio_urls,以及 image_with_roles 中的 reference_image)不能同时出现,混用会返回 400
不能只给音频。 传了 audio_urls 时,必须至少再配一个参考图或参考视频。

请求参数

通用字段

string
必填
固定值:MiniMax-H3
必须显式传递 model 字段。 已接入海螺系列的客户端将 model 改为 MiniMax-H3 即可使用本模型。
string
必填
视频内容描述,任何场景都必填且不能为空,单条 ≤ 7000 字符建议详细描述场景、主体、动作、风格等,以获得更好的生成效果。示例:"一个男孩在海边打篮球,黄昏,海浪拍岸,电影感运镜"
integer
默认值:"5"
生成时长(秒)
  • 取值范围:4 ~ 15 的整数
  • 默认值:5
string
默认值:"2K"
视频分辨率
  • 仅支持:2K(默认)
string
宽高比。也可用 sizeratio 传,效果相同。可选具体比例:21:916:94:31:13:49:16不同场景下的行为见下方「宽高比规则」。
boolean
默认值:"false"
是否添加 AIGC 水印默认值:false兼容字段名:aigc_watermark
string
任务到达终态(成功 / 失败)时,本服务主动推送到该地址
请使用 webhook,不要传官方的 callback_urlcallback_url 由本服务内部使用,不接受用户传入。

图生视频字段

要做首帧 / 尾帧图生视频,必须显式指定,不要依赖 image_urls 张数推断。
string
首帧图 URL传入后将以该图片作为视频的起始画面
string
尾帧图 URL传入后将以该图片作为视频的结束画面,可与 first_frame_image 组合实现首尾帧控制。

多模态参考字段

string[]
参考图 URL 数组
image_urls 里的图一律按参考图(reference_image)处理,不管传几张。不会按张数自动当成首帧 / 首尾帧。
  • 数量:≤ 9
string[]
参考视频 URL 数组
  • 数量:≤ 3
  • 格式与限制见下方「输入媒体限制」
string[]
参考音频 URL 数组
  • 数量:≤ 3
  • 不能单独使用,必须搭配参考图或参考视频

通用图片数组(可选写法)

object[]
带角色的图片数组,可替代 first_frame_image / last_frame_image / image_urls。每个元素结构如下:示例(首尾帧):
示例(参考图):

宽高比规则

可用具体比例:21:916:94:31:13:49:16

输入媒体限制

请求体总大小 ≤ 64 MB。大文件请使用公网 URL,不要使用 Base64

图片

视频(仅多模态参考场景)

音频(仅多模态参考场景)

参数约束

以下约束违反时请求将被拒绝并返回 400(敏感内容可能返回 422),且 不产生计费

响应

integer
响应状态码,成功时为 200
array
返回数据数组

请求示例

场景 1:文生视频

场景 2:图生视频 — 首帧

场景 3:图生视频 — 首尾帧

场景 4:多模态参考生视频

场景 5:使用 image_with_roles 指定首尾帧

查询任务结果视频生成为异步任务,提交后会返回 task_id。使用 获取任务状态 接口查询生成进度和结果。建议每 5 ~ 10 秒轮询一次,客户端超时建议设为 15 分钟。成功后 result.videos[0].url 为 mp4 地址;视频 URL 约 24 小时有效,请及时转存。任务失败时会自动退款。