Skip to main content

MiniMax H3 视频

MiniMax H3 在 Geeknow 中通过统一的视频网关异步生成视频。开发者只需要使用公开的 /v1/videos 路由;上游 DMC 的 /v2/video_generation/v2/query/video_generation/{task_id} 属于服务内部链路,不应直接写入客户端。

能力与固定规格

请求体使用上游 H3 的 content[] 结构:一个文本项可以组合首帧、尾帧、参考图片、参考视频和参考音频。 adaptive 是上游能力的一部分,但当前 Geeknow 插件适配层只提交固定画幅;未传或不支持的比例会回退为 16:9。传入历史 2K 模型名也不会得到 2K,最终输出仍是 768P

支持的生成方式

媒体约束

所有媒体必须是服务端可以直接访问的公网 HTTPS URL。不要提交 Base64、data URI、mm_file://、本地路径、私网地址或回环地址。插件收到本地图片时会先上传为 HTTPS URL,再提交给网关。 全部媒体项合计最多 12 个。参考视频和参考音频每段至少 2 秒,超过 15 秒时只保留开头 15 秒;裁切后的参考视频总时长和独立参考音频总时长分别不能超过 15 秒。图片应为静态 JPG/JPEG、PNG、WebP、HEIC 或 HEIF。 参考素材应在提示词中按出现顺序使用 <Picture 1><Video 1><Audio 1> 等标签指代。一个请求必须且只能有一个非空文本项,文本最多 7000 个 Unicode 字符。

任务生命周期

创建成功只代表任务已受理。服务可能在 queued 阶段下载、探测、转码和审核输入,之后才开始生成。 输入下载、媒体格式、内容审核和服务繁忙等问题可能在创建返回 task_id 后才以 failed 表示。查询失败任务通常仍返回 HTTP 200,请读取 task.error

创建与查询

创建视频任务

使用 content[] 提交文生、关键帧和多参考素材任务。

查询视频任务

轮询状态,读取 task.content.url 或兼容响应中的 video_url

结果与计费

成功任务的结果地址应直接使用查询响应返回的完整 URL,不要根据 task_id 拼接地址。公开结果地址可能在服务清理后失效;需要长期保存时,请在任务成功后尽快下载到自己的存储。查询接口仍需 Bearer 鉴权,返回的公开结果 URL 下载时不要附带该鉴权头;如果直链不可用,可以使用带鉴权的 /content 代理端点。 当前用量按客户提交的输出 duration 统计,关键帧和参考素材不会改变输出秒数计费口径。正式单价、额度和账单以账户后台为准。

明确不提供

  • 2K 输出;
  • adaptive 画幅透传;
  • 提示词增强、视频再生成、任务列表筛选和公开取消接口;
  • Base64、data URI、动态图片和自定义推理参数;
  • SSE 或本页未列出的 MiniMax 官方接口。

推荐阅读

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