MiniMax-H3 视频

本页仅描述本站当前 MiniMax-H3 的接口：视频分组、固定 768P、1–15 秒整数、按请求的输出秒数计费。核对日期：2026-10-29。不要套用其他平台同品牌模型的 2K、10 秒固定档或其他参数。

文生视频最小请求

POST /v1/videos。下载 h3-text.json：

json

{
  "model": "MiniMax-H3",
  "prompt": "清晨湖面上的蓝色纸船缓缓漂动，柔和光线，镜头平稳推进",
  "seconds": "5",
  "resolution": "768P",
  "ratio": "16:9"
}

bash

curl --fail-with-body --max-time 120 \
  https://openpix.cc/v1/videos \
  -H "Authorization: Bearer $MXB_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-binary @h3-text.json

成功后保存本站 id，通过 GET /v1/videos/{id} 查询，完成后从 /content 下载。

请求字段

字段	类型	取值与说明
model	string，必填	`MiniMax-H3`
prompt	string	1–7000 个 Unicode 字符；也可放在 content 的唯一 text 项中
seconds	string 或 integer	默认 5；1–15 秒整数
duration	integer，可选	seconds 的别名，JSON 中建议使用整数
resolution	string，可选	默认且仅支持 `768P`，注意大写 P
ratio	string，可选	21:9、16:9、4:3、1:1、3:4、9:16、adaptive
images	string[]，可选	简写模式：第一张为首帧，第二张为尾帧，最多两张
input_reference / image	string，可选	单张 HTTPS 图片简写，作为首帧
content / metadata.content	array，可选	一项 text 与最多 12 项参考素材；二选一
metadata.first_frame_image	string，可选	首帧 HTTPS URL
metadata.last_frame_image	string，可选	尾帧 HTTPS URL
size	string，可选	768P 或下表画布尺寸；不要与 ratio 冲突

本接口未开放统一的 generate_audio、watermark、seed 或 callback_url 参数，不要随意添加。没有自动回调，请轮询状态。

没有视觉素材时 ratio 默认 16:9，有图片或视频时默认 adaptive。为了稳定复现，建议显式传入比例。adaptive 需要图片或视频，纯文字或纯音频不能使用。

比例与画布

ratio	可用 size
21:9	1536x672
16:9	1344x768
4:3	1024x768
1:1	768x768
3:4	768x1024
9:16	768x1344

这些是可接受的参数映射；成片应读取实际媒体信息。不要将 size 写成 720p、1080p 或 2K。

单首帧与首尾帧

单首帧请求：

json

{
  "model": "MiniMax-H3",
  "prompt": "以首帧画面开始，镜头缓慢向前，保持产品外观一致",
  "seconds": "5",
  "resolution": "768P",
  "ratio": "16:9",
  "input_reference": "https://media.example.com/first.png"
}

请将示例域名替换成真实自有素材。需要首尾帧时，将 input_reference 改成：

json

{
  "metadata": {
    "first_frame_image": "https://media.example.com/first.png",
    "last_frame_image": "https://media.example.com/last.png"
  }
}

这是要加入完整请求的字段片段。也可以用 images:[首帧URL,尾帧URL]，不要同时使用两套字段。

H3 的接口接受单首帧，也接受单尾帧的显式角色；首尾帧各最多一张。关键帧模式不能与 reference_image、reference_video、reference_audio 混用。这与 Mini/Fast 必须成对提供首尾帧的规则不同。

多参考图、视频与音频

三张以上图片必须用显式参考角色，不能放进 images 简写：

json

{
  "model": "MiniMax-H3",
  "seconds": "5",
  "resolution": "768P",
  "ratio": "16:9",
  "metadata": {
    "content": [
      {"type": "text", "text": "参考人物造型与场景，制作自然流畅的短片"},
      {"type": "image_url", "image_url": {"url": "https://media.example.com/person.png"}, "role": "reference_image"},
      {"type": "video_url", "video_url": {"url": "https://media.example.com/movement.mp4"}, "role": "reference_video"},
      {"type": "audio_url", "audio_url": {"url": "https://media.example.com/music.wav"}, "role": "reference_audio"}
    ]
  }
}

类型	单类数量上限	必须使用的角色
图片	9	reference_image
视频	3	reference_video
音频	3	reference_audio
全部参考素材	合计 12	不包括唯一 text 项

content 内必须有且只有一个 text。媒体字段统一使用 {"url":"https://..." } 对象格式，不能把整个媒体对象换成裸 URL 字符串。多图必须明确 role；不要依赖单图默认首帧的行为来表达参考图。

视频接口只接收可读取的 HTTPS 媒体地址，不接受此型号的二进制 multipart 文件或 Base64 图片。参考素材兼容情况要用自己的真实文件验证，不要把 Mini/Fast 的具体文件时长限制直接当作 H3 的统一限制。

计费与失败处理

核对时基础价为 ¤0.06 / 请求的输出秒数，视频分组倍率为 1。1 秒约 ¤0.06，5 秒约 ¤0.30，15 秒约 ¤0.90。参考图片数量和成片容器时长不改变本规则中的名义输出秒数。

提交受理后通常先预扣，任务完成或明确失败后按账单记录核对。客户端停止等待不等于任务取消；下载失败不等于生成失败。具体状态与恢复流程见视频任务与下载。