Skip to main content
POST
Create a MiniMax-H3/H3-Max v2 video task

接口范围

MiniMax 官方 H3/H3-Max v2 能力使用 POST /v2/video_generation 创建任务,并使用 GET /v2/query/video_generation/{task_id} 查询任务。它支持 URL、mm_file 和 data URI 形式的媒体输入。H3 为 768P/2K、4–15 秒;H3-Max 为 480P/768P、5–15 秒。 OneHub 将该能力代理为以下鉴权接口;两者都必须带 Bearer Token:
model 可为 MiniMax-H3MiniMax-H3-Max。H3-Max 只接受文本和首/尾帧图片, 不接受参考素材;minimax-h3-768p-secondminimax-h3-2k-secondminimax-h3-extra-input-image 是 OneHub 内部计费组件 SKU;minimax-h3-max-480p-secondminimax-h3-max-768p-second 是 H3-Max 内部 计费组件 SKU。它们不能作为 model 值,也不是可配置的模型 allowlist 条目。

创建请求

  • duration 必填;H3 为 4–15 秒,H3-Max 为 5–15 秒。
  • resolution 可省略(默认 768P);H3 只能为 768P/2K,H3-Max 只能为 480P/768P
  • content 必须恰好有一个非空 text 项,提示词最多 7000 个 Unicode 字符; text 项不能设置 role
  • 媒体项总数最多 12:image_url 最多一个 first_frame、一个 last_frame、9 个 reference_imagevideo_url 最多 3 个 reference_videoaudio_url 最多 3 个 reference_audioimage_url 未提供 role 时会按 first_frame 处理。
  • 首/尾帧模式不能与任何参考素材混用;只有 reference_audio 时,必须同时提供 reference_imagereference_video

比例与模式

  • 文生视频:没有媒体项时,ratio 必填,且必须是具体比例,不能为 adaptive
  • 首/尾帧:包含 first_framelast_frame 时,OneHub 使用 adaptive
  • 参考素材:包含任一 reference_* 项时,ratio 可省略(会使用 adaptive), 也可以传 adaptive 或具体比例。
H3-Max 只支持上述首/尾帧模式,不支持参考素材。 可用比例为 adaptive21:916:94:31:13:49:16;前述模式规则会 进一步限制其可用性。

媒体 locator 与大小限制

每个 image_url.urlvideo_url.urlaudio_url.url 只能使用下列 locator:
  • 公网 https:// URL。OneHub 会对 URL 做 DNS fail-closed 和私网/回环地址拦截; 不接受 HTTP、file:ftp:blob:javascript: 或协议相对 URL。
  • 严格的 data:<mime>;base64,<payload>。metadata 必须恰为 <mime>;base64,不能有 空白字符,payload 必须是非空严格 Base64。
  • authority-only 的 mm_file://<positive-int64>。只允许正十进制 int64 authority, 不能包含用户信息、端口、路径、query 或 fragment。
对 data URI,OneHub 会验证解码后单文件大小与 MIME: 公网 HTTPS URL 和 mm_file 引用不会由 OneHub 拉取或在本地检查媒体内容,媒体格式等 官方约束由上游校验。完整 JSON 请求体最大为 64 MiB;data URI 的 Base64 膨胀和其他 字段也计入该限制,因此实际可用的解码后大小会低于单文件上限。

创建示例

创建成功只返回 OneHub 的稳定公共标识:

查询任务

将创建响应的 task_id(或 platform_id)放入路径参数:
查询响应保持上游 task 对象,并在顶层附加 platform_idbase_resp 也可能出现。 task 可包含 idstatusmodeltask_typeresolutiondurationcreated_atupdated_atcontent.urlusageerrorstatus 与时间字段以 上游实际返回为准。
成功结果中的 task.content.url 是上游签名 URL。它会过期,具体有效期以该 URL 与上游 返回为准;请在收到后及时使用,不要把完整签名 URL 写入日志或长期存储。 本文档不对创建失败、任务失败或取消时的计费结果作额外承诺;计费与额度以 OneHub 账户 和实际任务结算记录为准。

Authorizations

Authorization
string
header
required

Authorization: Bearer

Body

application/json
model
enum<string>
required
Available options:
MiniMax-H3,
MiniMax-H3-Max
content
object[]
required

Exactly one text item and at most 12 media items.

Required array length: 1 - 13 elements
duration
integer
required

Output duration in seconds (H3: 4-15; H3-Max: 5-15).

Required range: 4 <= x <= 15
resolution
enum<string>
default:768P

H3 supports 768P/2K; H3-Max supports 480P/768P.

Available options:
480P,
768P,
2K
ratio
enum<string>

Required and concrete for text-only generation; adaptive is used for first/last-frame mode and is the default for reference mode.

Available options:
adaptive,
21:9,
16:9,
4:3,
1:1,
3:4,
9:16
callback_url
string

Response

200 - application/json

Created task identifiers.

task_id
string
required

Upstream task identifier.

platform_id
string
required

OneHub platform task identifier.