MiniMax H3
MiniMax H3 视频生成
使用 POST /v1/videos 调用 MiniMax H3 普通档或 Pro 参考视频档提交视频生成任务。
POST
MiniMax H3 视频生成
MiniMax H3 系列通过POST /v1/videos 提交异步任务。当前文档把普通档和 Pro 参考视频档放在同一个 H3 系列中说明,不单开 Pro 系列。
选择模型时先看是否需要参考视频:普通档是 503,不支持参考视频;Pro 档是 913,支持 1 段 2 到 5 秒参考视频。然后再选择 768P 或 2K 清晰度。
模型选择
所有 H3 模型都按输出秒数统计用量,失败任务不计入成功用量。
duration 是用量统计的关键字段,接入方需要保证模型名、清晰度和参考素材能力一致。
生成能力
duration 支持 4 到 15 秒,必须是整数秒。ratio 支持 16:9、9:16、1:1、21:9、4:3、3:4。
方法与路径
请求示例
响应示例
认证
使用 Bearer Token 鉴权:Body
string
required
模型名称。推荐直接传真实模型:
minimax-h3-768p、minimax-h3-2k、minimax-h3-pro-768p 或 minimax-h3-pro-2k。也兼容传前端单入口 minimax-h3。此时适配层会读取 resolution、video_resolution 或 size:值为 2K 或包含 2160 时分流到 minimax-h3-2k,其他情况分流到 minimax-h3-768p。minimax-h3 不会自动分流到 Pro 档。string
required
视频生成提示词。建议控制在
7000 字符以内,并明确主体、动作、镜头、风格和画面节奏。integer
required
输出视频时长,单位为秒。支持
4 到 15 的整数值。按秒计费时,用量按输出秒数计算。string
画幅比例。当前项目支持
16:9、9:16、1:1、21:9、4:3、3:4。未传或传入不支持的值时,适配层会回退为 16:9。string
单入口
minimax-h3 的清晰度选择。支持 768P 和 2K。包含 2k 或 2160 的值会映射为 2K,其他值默认按 768P 处理。如果 model 已经是具体模型名,不需要再传这个字段;实际模型以 model 为准。string
resolution 的兼容字段,规则相同。string
resolution 的兼容字段。插件前端会把清晰度选择保存到 size,并同步保存到 resolution 和 video_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-768p 和 minimax-h3-pro-2k 支持。最多 1 段,时长 2 到 5 秒。请上传需要控制的关键片段,并传入公网可访问的 MP4 URL;可叠加 referenceImages、referenceAudios、first_image 和 last_image。请求构造规则
模型分流规则
注意事项
minimax-h3是当前插件的前端单入口值,不是最终模型名;直接接入 API 时建议传四个真实模型之一。- 普通档和 Pro 档的能力差异是参考视频;
768P与2K的差异是输出清晰度。 - 普通档参考规格是
503:最多 5 张参考图、0 段参考视频、3 段参考音频。 - Pro 档参考规格是
913:最多 9 张参考图、1 段参考视频、3 段参考音频。参考视频放在referenceVideos,建议只上传 2 到 5 秒关键片段。 - 当前项目 H3 适配层不透出
adaptive画幅;如果传入不支持的比例,会回退为16:9。 - 2K 和参考视频任务可能更慢,高峰期偶发排队;任务失败后可重新提交。
first_image/last_image与referenceImages不要混用,避免上游把生成模式判定错。- 如需核对用量或账户信息,请以账户后台和相关查询接口为准。