MiniMax H3 视频
MiniMax H3 系列使用POST /v1/videos 创建异步视频任务,使用 GET /v1/videos/{task_id} 查询状态,并可通过 GET /v1/videos/{task_id}/content 下载生成结果。
当前项目把 H3 和 H3 Pro 放在同一个 MiniMax H3 系列里,不单开 Pro 系列。开发者先判断是否需要参考视频,再判断输出清晰度:
- 普通档:
minimax-h3-768p、minimax-h3-2k,全能参考规格为503,不接收参考视频。 - Pro 档:
minimax-h3-pro-768p、minimax-h3-pro-2k,全能参考规格为913,增加 1 段参考视频输入。 768P和2K是清晰度差异,不是能力差异。
先选模型
入口映射
直接调用 API 时,推荐把model 写成真实模型名:minimax-h3-768p、minimax-h3-2k、minimax-h3-pro-768p 或 minimax-h3-pro-2k。
前端插件为了简化配置,会展示一个单入口 minimax-h3。当前适配层只把这个单入口分流到普通档,不会自动选择 Pro 档:
- 清晰度是
2K或字段值包含2160时,实际模型使用minimax-h3-2k。 - 其他情况默认使用
minimax-h3-768p。 - 如果调用方已经直接传
minimax-h3-768p、minimax-h3-2k、minimax-h3-pro-768p或minimax-h3-pro-2k,以传入的真实模型为准。 - 需要参考视频时,请直接传 Pro 模型名,并把 2 到 5 秒关键片段放进
referenceVideos。
创建视频任务
使用 H3 普通档或 Pro 档提交文生视频、图生视频、首尾帧、参考音频和参考视频任务。
查询视频任务
使用
GET /v1/videos/{task_id} 轮询任务状态,并在完成后获取结果地址。支持能力
接口约定
当前边界
- Pro 模型不单开系列页面,统一写在 MiniMax H3 系列里。
- 当前插件前端单入口
minimax-h3只自动分流普通档;Pro 档需要直接传minimax-h3-pro-768p或minimax-h3-pro-2k。 - 当前项目 H3 适配层不透出
adaptive画幅;如果传入不支持的比例,会回退为16:9。 - 2K 或参考视频任务生成耗时可能更长,高峰期偶发排队;任务失败后可重新提交。