跳转到主要内容
POST

授权

Authorization
string
header
必填

HTTP: Bearer Auth

  • Security Scheme Type: http
  • HTTP Authorization Scheme: Bearer API_key，用于验证账户信息，可在 账户管理>接口密钥 中查看。

请求头

Content-Type
enum<string>
默认值:application/json
必填

请求体的媒介类型，请设置为 application/json。

可用选项:
application/json

请求体

application/json
model
enum<string>
必填

模型名称。当前可用值：MiniMax-H3、MiniMax-H3-Highspeed、MiniMax-H3-Lite、MiniMax-H3-Max。

  • MiniMax-H3：适合高品质视频创作的版本。支持文生视频、图生视频（首帧 / 尾帧）与多模态参考生视频；分辨率 768P / 2K，时长 4~15 秒。
  • MiniMax-H3-Highspeed：兼顾生成质量与速度的版本。支持文生视频、图生视频（首帧 / 尾帧）与多模态参考生视频（参考图 / 参考视频 / 参考音频）；分辨率 480P / 768P，不支持 2K；时长 4~15 秒。
  • MiniMax-H3-Lite：轻量版本。支持文生视频、图生视频（首帧 / 尾帧）与多模态参考生视频（参考图 / 参考视频 / 参考音频）；分辨率 480P / 768P，不支持 2K；时长 4~15 秒。
  • MiniMax-H3-Max：极速生成版本。支持文生视频、图生视频（首帧 / 尾帧）与多模态参考生视频（参考图 / 参考视频 / 参考音频）；分辨率 480P / 768P，不支持 2K；时长 5~15 秒。
可用选项:
MiniMax-H3,
MiniMax-H3-Highspeed,
MiniMax-H3-Lite,
MiniMax-H3-Max
content
object[]
必填

多模态输入内容数组，描述用于生成视频的信息。每个元素通过 type 区分类型（text / image_url / video_url / audio_url），并可通过 role 标注用途。

每次请求必须包含一个非空 text 项（prompt 必填）；缺失会返回参数错误。

支持的输入组合（对应不同生成场景）：

  • 文生视频：仅一个 text 元素。
  • 图生视频-首帧：text + 1 张 image_url（role=first_frame 或不填）。
  • 图生视频-尾帧：text + 1 张 image_url（role=last_frame）。
  • 图生视频-首尾帧：text + 2 张 image_url（role 分别为 first_frame、last_frame）。
  • 多模态参考生视频：text + 参考图片（role=reference_image）+ 参考视频（role=reference_video）+ 参考音频（role=reference_audio）的组合。

图生视频与多模态参考生视频互斥：content 中出现 reference_image / reference_video / reference_audio 任一 role，就不能再出现 first_frame / last_frame（反之亦然），二者不可混用。

输入媒体限制（请求体总大小 ≤ 64 MB，大文件请用公网 URL，勿用 Base64）

图片 image_url：

视频 video_url（仅多模态参考场景）：

音频 audio_url（仅多模态参考场景）：

resolution
enum<string>
必填

视频分辨率。不同模型支持的档位不同：

  • MiniMax-H3：768P、2K
  • MiniMax-H3-Highspeed：480P、768P（不支持 2K）
  • MiniMax-H3-Lite：480P、768P（不支持 2K）
  • MiniMax-H3-Max：480P、768P（不支持 2K）
可用选项:
480P,
768P,
2K
duration
enum<integer>
必填

生成视频时长（秒），必选，整数。不同模型可用值不同：

  • MiniMax-H3：4~15
  • MiniMax-H3-Highspeed：4~15
  • MiniMax-H3-Lite：4~15
  • MiniMax-H3-Max：5~15（不支持 4 秒）
可用选项:
4,
5,
6,
7,
8,
9,
10,
11,
12,
13,
14,
15
ratio
enum<string>

生成视频的宽高比，默认 adaptive（自动，由输入自适应选择最合适的宽高比，实际比例可在查询接口的 ratio 字段获取）。可用值：adaptive、21:9、16:9、4:3、1:1、3:4、9:16。

文生视频（t2va，content 仅含 text）：ratio 必填，且不能为 adaptive；可用值 21:9、16:9、4:3、1:1、3:4、9:16。

图生视频（i2va，content 含 first_frame / last_frame 图片）：宽高比由输入图片决定，ratio 恒为 adaptive；传入其他合理值不会报错，但会被忽略并按 adaptive 处理。

多模态参考生视频（r2va，content 含 reference_image / reference_video / reference_audio）：ratio 可选，默认 adaptive；也可显式指定上述任一具体比例。MiniMax-H3-Lite 暂不支持 adaptive，需显式指定具体比例。

可用选项:
adaptive,
21:9,
16:9,
4:3,
1:1,
3:4,
9:16
extra
object

MiniMax-H3-Max 的额外生成选项。当前仅支持 prompt_expansion_mode。不传 extra 或不传此属性时，使用 balanced。不要传 balance、空字符串、布尔值或其他未声明字段。

callback_url
string

任务状态变更的回调通知地址。配置后 MiniMax 服务器会先发送含 challenge 字段的验证请求（需 3 秒内原样返回 challenge 完成验证），验证成功后每当任务状态变更即向该地址 POST 推送，推送体结构与查询任务接口的响应一致。

回调 status 取值：queued（排队中）、running（运行中）、succeeded（成功）、failed（失败）、cancelled（已取消）。

aigc_watermark
boolean

是否在生成视频中添加 AIGC 标识水印，默认 false。

response_format
enum<string>
默认值:task

响应格式。

  • task（默认）：返回 {"task": {...}}，任务字段包在 task 对象内。
  • flat：任务字段直接平铺在响应顶层（包含 usage），与查询任务列表的 items[] 形状一致。
可用选项:
task,
flat

响应

创建成功后返回 task_id。使用该 task_id 调用查询任务接口获取任务状态与结果。

查询任务成功响应示例

task_id
string

任务 ID，用于后续查询任务状态与结果。