MiniMax H3
MiniMax H3:按秒计费、固定 768P,首尾帧或图 / 视频 / 音频三类参考素材,图片可传 base64,以及会被当场拒绝的写法
POST /v1/videos,model 为 MiniMax-H3。按秒计费,见视频生成。本页结论来自对本网关的真实调用,最后验证:2026-10-26。
基本调用
# 1. 提交
curl https://www.vibeapi.cn/v1/videos \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "MiniMax-H3",
"prompt": "日出时分的海面,镜头极缓慢推进,电影级布光",
"seconds": "5",
"aspect_ratio": "16:9"
}'
# 2. 轮询(每 10~15 秒一次)
curl "https://www.vibeapi.cn/v1/videos/$TASK_ID" -H "Authorization: Bearer $API_KEY"
# 3. 取片
curl -L "https://www.vibeapi.cn/v1/videos/$TASK_ID/content" \
-H "Authorization: Bearer $API_KEY" -o output.mp4import time, requests
BASE = "https://www.vibeapi.cn/v1"
H = {"Authorization": "Bearer YOUR_API_KEY"}
task = requests.post(f"{BASE}/videos", headers=H, json={
"model": "MiniMax-H3",
"prompt": "日出时分的海面,镜头极缓慢推进,电影级布光",
"seconds": "5",
"aspect_ratio": "16:9",
}).json()
while True:
s = requests.get(f"{BASE}/videos/{task['id']}", headers=H).json()
if s["status"] in ("completed", "failed"):
break
time.sleep(12)
if s["status"] == "completed":
url = s.get("metadata", {}).get("url") or f"{BASE}/videos/{task['id']}/content"
open("output.mp4", "wb").write(requests.get(url, headers=H).content)import fs from "fs";
const BASE = "https://www.vibeapi.cn/v1";
const H = { Authorization: "Bearer YOUR_API_KEY", "Content-Type": "application/json" };
const sleep = (ms) => new Promise((r) => setTimeout(r, ms));
const task = await (await fetch(`${BASE}/videos`, {
method: "POST",
headers: H,
body: JSON.stringify({
model: "MiniMax-H3",
prompt: "日出时分的海面,镜头极缓慢推进,电影级布光",
seconds: "5",
aspect_ratio: "16:9",
}),
})).json();
let s;
while (true) {
s = await (await fetch(`${BASE}/videos/${task.id}`, { headers: H })).json();
if (s.status === "completed" || s.status === "failed") break;
await sleep(12_000);
}
if (s.status === "completed") {
const url = s.metadata?.url ?? `${BASE}/videos/${task.id}/content`;
fs.writeFileSync("output.mp4", Buffer.from(await (await fetch(url, { headers: H })).arrayBuffer()));
}按秒计费,固定 768P,整数 1–15 秒。特点是参考素材的种类最全:图、视频、音频三类
可以同时给,提示词里用 <Picture 1> <Video 1> <Audio 1> 按顺序引用。
参数
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
model | string | 是 | 固定 MiniMax-H3 |
prompt | string | 是 | 最长 7000 字符 |
seconds | string | 建议 | 输出时长,整数 1–15;也接受数字型 duration。不传按 5 秒 |
aspect_ratio | string | 否 | 21:9 16:9(默认)4:3 1:1 3:4 9:16,另见下方 adaptive |
image_urls | string[] | 否 | 参考图,最多 9 张,顺序即 <Picture N> 编号 |
first_frame_image | string | 否 | 首帧图,也可以用 input_reference |
last_frame_image | string | 否 | 尾帧图 |
video_urls | string[] | 否 | 参考视频,最多 3 条 |
audio_urls | string[] | 否 | 参考音频,最多 3 个 |
分辨率不用传,固定 768P,传了也不生效。
adaptive 比例只在带了参考图或参考视频时可用——它的意思是跟着视觉输入定画布,
纯文生和纯音频请求没有可跟的对象,会直接报错。
三类参考素材合计不超过 12 个,且每一类各有上限。
首尾帧和参考图二选一:给了 first_frame_image / last_frame_image 就不能再给 image_urls。
图片传 base64
所有图片字段都可以传公网 HTTPS 地址,也可以直接传 base64,带不带 data:image/png;base64, 前缀都行。
参考视频和参考音频只收 HTTPS 地址。
IMG=$(base64 -w0 cat.jpg) # macOS 用 base64 -i cat.jpg
curl https://www.vibeapi.cn/v1/videos \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "MiniMax-H3",
"prompt": "小猫慢慢抬起头,看向镜头",
"seconds": "5",
"aspect_ratio": "adaptive",
"first_frame_image": "'"$IMG"'"
}'用 OpenAI SDK 上传本地文件也可以:multipart 表单里的 input_reference 文件,第一张作首帧、第二张作尾帧,单张不超过 20 MB。
from openai import OpenAI
client = OpenAI(base_url="https://www.vibeapi.cn/v1", api_key="YOUR_API_KEY")
video = client.videos.create(
model="MiniMax-H3",
prompt="小猫慢慢抬起头,看向镜头",
seconds="5",
input_reference=open("cat.jpg", "rb"),
)多参考素材
curl https://www.vibeapi.cn/v1/videos \
-H "Authorization: Bearer $API_KEY" \
-H 'Content-Type: application/json' \
-d '{
"model": "MiniMax-H3",
"prompt": "<Picture 1> 中的人物,按 <Video 1> 的运镜节奏,配合 <Audio 1> 的节拍",
"seconds": "8",
"aspect_ratio": "adaptive",
"image_urls": ["https://your-cdn.example.com/person.jpg"],
"video_urls": ["https://your-cdn.example.com/motion.mp4"],
"audio_urls": ["https://your-cdn.example.com/beat.mp3"]
}'参考视频和参考音频必须是公网可直接下载的 HTTPS 地址;图片也可以传 base64,见上一节。
已知限制(截至 2026-10-26)
| 限制 | 说明 | 怎么办 |
|---|---|---|
| 固定 768P | 没有分辨率参数,传了不生效 | 要 1080p 用万相或 Seedance |
adaptive 有条件 | 只在带了参考图或参考视频时可用,纯文生 / 纯音频请求 400 | 纯文生传固定比例 |
| 参考视频 / 音频超 15 秒只取片头 | 各自累计不得超过 15 秒,超了任务失败 | 先自己剪 |
| 出片时间 | 4.5–10 分钟,15 秒的更久 | 轮询超时按 20 分钟设;曾出现上游已完成但状态停在「生成中」的情况,2026-09-15 起已修复,若再遇到请把任务 ID 反馈给我们 |
| 取片地址 | metadata.url 是本站 /content 代理地址,带同一个 key 下载 | 视频不长期保存,取到就落盘 |
商业方向样片
所有底图都是用 gpt-image-2.5-sunburst 出的(横版 2560×1440、竖版 1440×2560),
再作为首帧 / 参考图交给本页模型,提示词只写运镜与动态。成片保留原始音轨。
H3 是四个系列里唯一允许人物入镜且不卡人脸的,餐饮、服装这类要有人的方向优先用它; 固定 768P,横版 1344×768、竖版 768×1344。
素材限制
| 素材 | 数量 | 单文件 | 时长 |
|---|---|---|---|
| 图片 | 最多 9 张 | 30 MB | 不适用 |
| 视频 | 最多 3 条 | 50 MB | 单条最短 2 秒;超过 15 秒只取片头 15 秒 |
| 音频 | 最多 3 个 | 15 MB | 单个最短 2 秒;超过 15 秒只取片头 15 秒 |
图片还需满足:单边 256–5760 像素,宽高比 0.4–2.5,不能是动图。
参考视频与参考音频裁切后各自累计不得超过 15 秒,超了任务会失败。 被裁切不影响输出时长,你请求几秒就出几秒。
会被当场拒绝的写法
这些在提交时就返回 400,不会创建任务、不产生费用:
| 写法 | 报错 |
|---|---|
| 时长写 0、负数或超过 15 | duration must be an integer between 1 and 15 seconds |
| 比例不在六档之内 | unsupported ratio ... |
纯文生或纯音频用 adaptive | ratio adaptive requires at least one image or video input |
| 参考图超过 9 张 | at most 9 images are accepted |
| 参考视频或音频超过 3 个 | at most 3 reference videos/audios are accepted |
| 三类合计超过 12 个 | at most 12 media items are accepted in total |
| 首尾帧和参考图同时给 | first_frame/last_frame cannot be combined with reference_image |
input_reference 上传超过 2 个文件 | at most 2 input_reference files are accepted |
素材本身的问题(下载不到、格式不对、时长不够)要等异步阶段才知道,
表现为任务进入 failed,此时全额退款。
最后更新于