MiniMax 海螺 H3 视频 API

MiniMax-H3 文生 / 图生 / 多模态参考生视频——单条 4-15 秒、768P 或 2K,仅按成片计费。

HopBase 按 MiniMax 官方 v2 契约接入海螺 H3。这是异步 API:提交任务后轮询 HopBase 任务 ID。请使用已开通 MiniMax 分组的密钥,并在发起付费任务前用 GET /v1/models 确认可用性。

端点

方法	路径	用途
POST	`/v1/video/generate`	提交 MiniMax H3 视频任务
GET	`/v1/video/tasks/{task_id}`	查询单个任务
GET	`/v1/video/tasks`	列出当前用户的任务

所有请求使用 Authorization: Bearer sk-your-key 与 Content-Type: application/json。请求体镜像 MiniMax 官方 POST /v2/video_generation,并做严格解码:未知字段与多余 JSON 值会在调用上游前被拒绝。

模型

模型 ID	时长	分辨率	参考输入
`MiniMax-H3`	4-15 秒整数	`768P` / `2K`	最多 9 张图、3 段视频、3 段音频

请使用精确 ID MiniMax-H3,无别名;未知模型名会被拒绝。

请求契约

content 是多模态数组,必须且只能包含一个非空 text 元素(提示词,最长 7000 字符)。媒体元素须显式声明 role:

元素	role 取值	上限
`image_url`	`first_frame`(省略时默认)、`last_frame`、`reference_image`	首尾帧各 1 张,或参考图最多 9 张
`video_url`	`reference_video`(必须显式)	最多 3 段
`audio_url`	`reference_audio`(必须显式)	最多 3 段

首尾帧与 reference_* 元素在同一请求内互斥。

参考音频必须与至少一个图片或视频参考同时提供,不能单独输入;混合参考素材合计最多 12 个文件。

媒体 url 接受公网绝对 http(s) 地址或 data: URI(base64 内嵌)。mm_file:// 会被拒绝——该 file_id 归属你自己的 MiniMax 账号,网关无法代取。不支持 callback_url,请轮询任务获取进度。

输入与输出规格

输出:24 FPS;每条成片原生自带双声道音频——台词与配音在模型内生成,TTS 覆盖 11 种语言(中/英/日/韩/法/德/西等)。2K 指 16:9~9:16 之间短边 1440 像素(更宽比例保持约 370 万总像素,如 21:9 → 2976×1248);768P 同规则,短边 768 / 约 100 万像素。
图片:JPG / JPEG / PNG / WEBP / HEIC / HEIF,单张 ≤30 MB,边长 256-5760 px,宽高比 5:2~2:5。
参考视频:H.264 / H.265,单段 ≤50 MB,单段 2-15 秒且合计 ≤15 秒。
参考音频:WAV / MP3,单段 ≤15 MB,单段 2-15 秒且合计 ≤15 秒。
大小限制按单个素材计;整个请求体上限 64 MB,大素材建议用 URL 而非 data: 内嵌。

宽高比

文生视频:ratio 必填且不能为 adaptive,可选 21:9、16:9、4:3、1:1、3:4、9:16。
图生视频(首尾帧):成片比例恒随输入图片。任何合法 ratio 值都会被接受并归一为 adaptive(与官方行为一致);如需特定比例,请先把帧图裁剪成该比例。
多模态参考:ratio 可选,默认 adaptive。

示例——文生视频

curl https://api.hop-base.com/v1/video/generate \
  -H "Authorization: Bearer sk-your-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "MiniMax-H3",
    "content": [{ "type": "text", "text": "无人机航拍视角,清晨的雪山山脉,云海翻涌,金色阳光洒在山峰上" }],
    "resolution": "2K",
    "duration": 4,
    "ratio": "16:9"
  }'

提交返回 202 与 HopBase 任务 ID:

{ "id": "mmt60x430684635582774", "object": "video.generation.task", "model": "MiniMax-H3", "status": "queued", "billing_bucket": "2k" }

示例——图生视频

{
  "model": "MiniMax-H3",
  "content": [
    { "type": "text", "text": "镜头缓缓向前推近,画面中的光影微微流动" },
    { "type": "image_url", "image_url": { "url": "data:image/jpeg;base64,..." }, "role": "first_frame" }
  ],
  "resolution": "768P",
  "duration": 4
}

参考素材请用稳定图床或 data: 内嵌

参考媒体由上游而非 HopBase 下载。封锁机房 IP 的图床(很多免费图床都会)会让任务在提交几分钟后失败。建议优先使用 data: 内嵌或自有 OSS / CDN。

任务生命周期

轮询 GET /v1/video/tasks/{task_id},状态依次为 queued → processing → completed | failed,单条成片通常 1.5-3 分钟完成。完成后响应携带稳定的 HopBase 中继地址(上游下载链接有时效,中继会透明刷新):

{
  "id": "mmt60x430684635582774",
  "status": "completed",
  "outputs": ["https://api.hop-base.com/relay/..."],
  "usage": { "bucket": "2k", "billed_seconds": 4, "input_seconds": 0, "extra_input_images": 0 }
}

计费

仅在任务成功时计费,以上游回报的用量为准:

输出秒数与参考视频的输入秒数,按分辨率档(768P / 2K)计价。
输入图片前 5 张免费,超出部分按张计费。
参考音频免费;生成失败或命中安全审核不计费。

官方牌价见价格页,实际售价以登录后模型广场为准。

MiniMax 海螺 H3 视频 API

本页目录