Skip to main content
POST
模型选择: MiniMax-H3-Max 适合优先生成速度的文生视频、首尾帧控制和多模态参考场景。支持 480P、768P 和 1080P。需要 2K 或中间帧时,请使用 MiniMax-H3。

认证

string
必填
所有接口均使用 Bearer Token 认证。访问 API Key 管理页面 获取密钥。

选择模型

MiniMax-H3-Max 不支持 2K,也不能作为 Regeneration 的源任务。需要这些能力时请使用 MiniMax-H3。

生成模式

MiniMax-H3-Max 根据请求字段自动识别生成模式,无需传递 mode:
首尾帧字段与参考素材字段不能混用。参考音频不能单独使用,必须至少搭配一张参考图或一段参考视频。违反组合限制会同步返回 400,不创建任务、不扣费。

请求参数

string
必填
固定值:MiniMax-H3-Max模型 ID 大小写不敏感,minimax-h3-max 也可使用。
string
必填
视频内容描述,任何场景都必填且不能为空。
  • 上限:7000 个字符
  • 按字符数计算,中文一个字计一个字符
integer
默认值:"5"
视频时长(秒)。
  • 取值:5 ~ 15 的整数
  • 默认:5
  • 不支持 4 秒
string
默认值:"768P"
输出分辨率。
  • 768P(默认)
  • 480P
  • 1080P
选择 1080P 时,必须省略 watermark 和兼容字段 aigc_watermark,即使值为 false 也不要传。
不支持 2K、1440P 或 2048P,传入后会同步返回 400,不会自动降级。
string
输出宽高比。也可使用 size 或 ratio 传递。文生视频可选:21:9、16:9、4:3、1:1、3:4、9:16。
  • 文生视频不传或传 adaptive:自动回落为 16:9
  • 图生视频:宽高比由输入图片决定,此参数会被忽略
  • 多模态参考生视频:可选,默认 adaptive,也可指定具体比例
string
首帧图片的公网 URL。传入后以该图片作为视频起始画面。
string
尾帧图片的公网 URL。可以单独使用,也可与 first_frame_image 组合实现首尾帧控制。
object[]
带角色的图片数组,可替代 first_frame_image / last_frame_image / image_urls。首帧和尾帧各最多一张。此数组中的参考图与 image_urls 合计最多 9 张;首尾帧角色不能与参考图角色混用。
string[]
参考图片的公网 URL 数组,与 image_with_roles 中的参考图合计最多 9 张。数组中的图片一律作为参考图,不会按图片数量自动识别为首帧或首尾帧。首帧控制请使用 first_frame_image 或明确指定 first_frame 角色。
string[]
参考视频的公网 URL 数组。单段视频也可使用 video_url(string)传递。
  • 最多 3 段
  • 每段时长 2 ~ 15 秒
  • 所有参考视频总时长不得超过 15 秒
提交时会读取参考视频时长用于计费。无法读取时长时会同步返回 400,不创建任务、不扣费。
string[]
参考音频的公网 URL 数组。单段音频也可使用 audio_url(string)传递。
  • 最多 3 段
  • 每段时长 2 ~ 15 秒
  • 所有参考音频总时长不得超过 15 秒
  • 必须至少搭配一张参考图或一段参考视频,不能只传参考音频
boolean
默认值:"false"
是否添加 AIGC 水印。兼容字段名:aigc_watermark。仅适用于 480P / 768P。选择 1080P 时必须省略此字段及其兼容字段,不要传 true 或 false。
string
任务成功或失败时,本服务向该地址推送终态通知。
请使用 webhook,不要传 MiniMax 官方的 callback_url。callback_url 由本服务内部使用,不接受用户传入。

参数约束

以下参数或取值会同步返回 400,不创建任务、不扣费: 参考视频和参考音频均须满足单段 2 ~ 15 秒、各自总时长不超过 15 秒的限制。不能将超时素材当作有效输入;请先裁剪后再提交。
选择 1080P 时,不能传 watermark 或 aigc_watermark。请直接省略水印参数,而不是将其设为 false。
需要 2K、中间帧或 4 秒视频时,将 model 改为 MiniMax-H3,并按 MiniMax-H3 视频生成文档 调整参数。

输入媒体限制

请求体总大小不得超过 64 MB。图片、视频和音频请使用公网 URL,不要使用 Base64。

图片

参考视频

参考音频

参考音频必须搭配参考图或参考视频。视频总时长和音频总时长分别计算,各自不得超过 15 秒。 不符合输入媒体要求时,任务可能在生成阶段失败并自动退款。

请求示例

文生视频

首帧图生视频

首尾帧图生视频

使用 image_with_roles

1080P 文生视频

选择 1080P 时,请省略 watermark 和 aigc_watermark。

多模态参考生视频

以下参考视频和参考音频均须为 2 ~ 15 秒的有效素材。传多段时,视频和音频各自的总时长不得超过 15 秒。

查询任务

提交成功后返回 task_id。使用 获取任务状态 查询生成进度和结果:
建议每 5 ~ 10 秒轮询一次,客户端超时设置为 15 分钟。 任务成功时:
视频 URL 通常约 24 小时有效,请及时下载并转存。

计费

总费用包含生成视频费用、超额图片费用和参考视频费用:
首帧、尾帧和参考图合并计算输入图片张数。前 2 张免费,超出后按张收费;参考视频总时长不得超过 15 秒。 上述单价均以模型定价为准。 提交时预扣费用;任务失败会自动全额退款,最终金额以任务查询结果中的 cost 为准。

错误处理

生成阶段失败时,任务状态为 failed,error.message 会说明原因,预扣费用自动退回。

Response

integer
响应状态码,成功时为 200
array
提交时返回任务状态与任务 ID。