Skip to main content
POST

MiniMax H3 视频生成

MiniMax H3 系列通过 POST /v1/videos 提交异步任务。当前文档把普通档和 Pro 参考视频档放在同一个 H3 系列中说明,不单开 Pro 系列。 选择模型时先看是否需要参考视频:普通档是 503,不支持参考视频;Pro 档是 913,支持 1 段 2 到 5 秒参考视频。然后再选择 768P2K 清晰度。

模型选择

所有 H3 模型都按输出秒数统计用量,失败任务不计入成功用量。duration 是用量统计的关键字段,接入方需要保证模型名、清晰度和参考素材能力一致。

生成能力

duration 支持 415 秒,必须是整数秒。ratio 支持 16:99:161:121:94:33:4

方法与路径

请求示例

响应示例

认证

使用 Bearer Token 鉴权:
JSON 请求还需要携带:

Body

string
required
模型名称。推荐直接传真实模型:minimax-h3-768pminimax-h3-2kminimax-h3-pro-768pminimax-h3-pro-2k也兼容传前端单入口 minimax-h3。此时适配层会读取 resolutionvideo_resolutionsize:值为 2K 或包含 2160 时分流到 minimax-h3-2k,其他情况分流到 minimax-h3-768pminimax-h3 不会自动分流到 Pro 档。
string
required
视频生成提示词。建议控制在 7000 字符以内,并明确主体、动作、镜头、风格和画面节奏。
integer
required
输出视频时长,单位为秒。支持 415 的整数值。按秒计费时,用量按输出秒数计算。
string
画幅比例。当前项目支持 16:99:161:121:94:33:4。未传或传入不支持的值时,适配层会回退为 16:9
string
单入口 minimax-h3 的清晰度选择。支持 768P2K。包含 2k2160 的值会映射为 2K,其他值默认按 768P 处理。如果 model 已经是具体模型名,不需要再传这个字段;实际模型以 model 为准。
string
resolution 的兼容字段,规则相同。
string
resolution 的兼容字段。插件前端会把清晰度选择保存到 size,并同步保存到 resolutionvideo_resolution
array<string>
参考图数组。普通档最多 5 张,Pro 档最多 9 张。成员可以是公网图片 URL,也可以是 data:image/...;base64,...。本地路径不能直接作为 API 输入,客户端需要先转为公网 URL 或 data URI。
string
首帧图。支持公网图片 URL 或 data URI。用于首尾帧模式时,不要同时传 referenceImages
string
尾帧图。支持公网图片 URL 或 data URI。通常和 first_image 成对使用。
array<string>
参考音频数组,最多 3 段,合计建议不超过 15 秒。当前插件适配层仅保留 http://https:// 公网 URL,并要求同时存在至少 1 张 referenceImages
array<string>
参考视频数组,仅 minimax-h3-pro-768pminimax-h3-pro-2k 支持。最多 1 段,时长 2 到 5 秒。请上传需要控制的关键片段,并传入公网可访问的 MP4 URL;可叠加 referenceImagesreferenceAudiosfirst_imagelast_image

请求构造规则

模型分流规则

注意事项

  • minimax-h3 是当前插件的前端单入口值,不是最终模型名;直接接入 API 时建议传四个真实模型之一。
  • 普通档和 Pro 档的能力差异是参考视频;768P2K 的差异是输出清晰度。
  • 普通档参考规格是 503:最多 5 张参考图、0 段参考视频、3 段参考音频。
  • Pro 档参考规格是 913:最多 9 张参考图、1 段参考视频、3 段参考音频。参考视频放在 referenceVideos,建议只上传 2 到 5 秒关键片段。
  • 当前项目 H3 适配层不透出 adaptive 画幅;如果传入不支持的比例,会回退为 16:9
  • 2K 和参考视频任务可能更慢,高峰期偶发排队;任务失败后可重新提交。
  • first_image / last_imagereferenceImages 不要混用,避免上游把生成模式判定错。
  • 如需核对用量或账户信息,请以账户后台和相关查询接口为准。

相关接口