Skip to main content

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-768pminimax-h3-2k,全能参考规格为 503,不接收参考视频。
  • Pro 档:minimax-h3-pro-768pminimax-h3-pro-2k,全能参考规格为 913,增加 1 段参考视频输入。
  • 768P2K 是清晰度差异,不是能力差异。

先选模型

普通档和 Pro 档的关键差异是是否支持参考视频;768P2K 的关键差异是输出清晰度。不要把 2K 当作更强的生成模式,也不要期待普通档通过传 referenceVideos 自动升级为 Pro。

入口映射

直接调用 API 时,推荐把 model 写成真实模型名:minimax-h3-768pminimax-h3-2kminimax-h3-pro-768pminimax-h3-pro-2k 前端插件为了简化配置,会展示一个单入口 minimax-h3。当前适配层只把这个单入口分流到普通档,不会自动选择 Pro 档:
  1. 清晰度是 2K 或字段值包含 2160 时,实际模型使用 minimax-h3-2k
  2. 其他情况默认使用 minimax-h3-768p
  3. 如果调用方已经直接传 minimax-h3-768pminimax-h3-2kminimax-h3-pro-768pminimax-h3-pro-2k,以传入的真实模型为准。
  4. 需要参考视频时,请直接传 Pro 模型名,并把 2 到 5 秒关键片段放进 referenceVideos

创建视频任务

使用 H3 普通档或 Pro 档提交文生视频、图生视频、首尾帧、参考音频和参考视频任务。

查询视频任务

使用 GET /v1/videos/{task_id} 轮询任务状态,并在完成后获取结果地址。

支持能力

接口约定

当前边界

  • Pro 模型不单开系列页面,统一写在 MiniMax H3 系列里。
  • 当前插件前端单入口 minimax-h3 只自动分流普通档;Pro 档需要直接传 minimax-h3-pro-768pminimax-h3-pro-2k
  • 当前项目 H3 适配层不透出 adaptive 画幅;如果传入不支持的比例,会回退为 16:9
  • 2K 或参考视频任务生成耗时可能更长,高峰期偶发排队;任务失败后可重新提交。

推荐阅读

  1. MiniMax H3 创建视频任务
  2. MiniMax H3 查询视频任务
  3. 视频模型支持矩阵