MiniMax 视频 API 规范

本页是 MiniMax H3 视频模型 minimax-h3 的调用规范。它与其他视频模型共用 POST /v1/videos 创建、GET /v1/videos/{id} 轮询的流程；鉴权、素材上传、轮询状态、结果下载和错误处理见 视频 API 完整调用规范，本页只列出 H3 特有的字段和规则。

更新于 2026-10-13。H3 只卖 768P、1080P、2K 三个档位，480P 和 4K 已下架；新请求只支持轮询，不要设置 callback_url。

文生视频示例

curl --request POST 'https://api.88api.ai/v1/videos' \
  --header 'Authorization: Bearer sk-xxxx' \
  --header 'Content-Type: application/json' \
  --data-raw '{
    "model": "minimax-h3",
    "prompt": "雨夜城市中的银色跑车，低机位跟拍，霓虹倒影，电影感",
    "duration": 5,
    "resolution": "1080p",
    "ratio": "16:9"
  }'

提交后保存响应中的 id，用 GET /v1/videos/{id} 轮询到完成，再从完成响应的 url 下载成片。minimax_h3 是同一模型的另一个名称，调用方式和计费完全相同。

规格参数

H3 只有一个模型名，用 resolution 选择输出档位并按档位计费，用 ratio 选择画面比例：

• 2K 由超分工作流得到，不是原生生成。
• 不要用 size 传比例。size 只接受 1080p 这类档位或 1920x1080 这类宽×高，写成 16:9 会被当作分辨率而被拒绝。
• 成片自带音轨，不提供生成音频开关；实际时长通常比请求多约 0.1–0.6 秒。
• 参数不合规（档位、比例、时长、素材数量或组合）时，提交直接返回 400，不创建任务、不扣费。

生成耗时与轮询

H3 的生成耗时取决于请求参数：

• 常规请求（16:9、9:16 比例，文生、参考图或 768P 首尾帧）耗时较短，768P 约 2–3 分钟，1080P、2K 约 5–8 分钟。
• 其他比例、只给首帧、1080P/2K 首尾帧等组合耗时明显更长，排队时可能需要 10–60 分钟。

请把轮询超时设为 60 分钟以上，轮询间隔 10–30 秒即可。

参考素材

参考图片放 metadata.referenceImages，参考音频放 metadata.referenceAudios。参考图最多 9 张，参考音频最多 3 段，参考音频需要搭配至少 1 张参考图。

{
  "model": "minimax-h3",
  "prompt": "参考图中的人物随参考音频的节奏起舞，镜头缓慢环绕",
  "duration": 6,
  "resolution": "768p",
  "ratio": "16:9",
  "metadata": {
    "referenceImages": ["https://cdn.example.com/dancer.jpg"],
    "referenceAudios": ["https://cdn.example.com/music.mp3"]
  }
}

首尾帧

使用 metadata.firstFrame 与 metadata.lastFrame，不能与参考图片或参考音频混用。首尾帧都给、且为 768P 时出片最快；也可以只给首帧，或在 1080P、2K 使用首尾帧，但生成耗时更长。

{
  "model": "minimax-h3",
  "prompt": "镜头从清晨的海岸平滑推进到傍晚的同一海湾",
  "duration": 5,
  "resolution": "768p",
  "ratio": "16:9",
  "metadata": {
    "firstFrame": "https://cdn.example.com/start.jpg",
    "lastFrame": "https://cdn.example.com/end.jpg"
  }
}

顶层 images 的处理

顶层 images（或 input_reference）传 2 张时按首帧、尾帧处理；传 1 张或 3 张以上时，用途不固定（可能被当作参考图或首帧）。请改用 metadata.referenceImages 或 metadata.firstFrame/lastFrame 明确指定用途。

素材要求

• 图片和音频使用公网可访问的 HTTPS 链接，或 Base64 data URL；也可以用 multipart 表单直接上传本地图片、音频文件。
• 图片为 JPG、PNG 或 WebP，单张建议不超过 10 MB；音频为 MP3 或 WAV，单段不超过 20 MB；Base64 内联素材合计不超过 32 MB。
• 不要使用本机路径、内网地址或浏览器 blob: 链接。
• 成片链接有有效期（最短 24 小时），请在任务完成后及时下载保存。