快速开始
三次调用生成一条带声音的片子。你需要一把 API key —— 注册账号后在控制台里创建。
1. 提交
curl https://api.h3.studio/v2/video_generation \
-H "Authorization: Bearer $H3_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "MiniMax-H3",
"content": [{ "type": "text", "text": "黄昏时分礁岬上的灯塔，浪拍黑礁" }],
"resolution": "768P",
"duration": 5,
"ratio": "16:9"
}'
{ "task_id": "424010985738629" }
这个调用立即返回。生成本身要 82 到 229 秒（取决于档位），所以这套 API 没有任何一处会阻塞。
2. 轮询
curl "https://api.h3.studio/v2/query/video_generation/$TASK_ID" \
-H "Authorization: Bearer $H3_API_KEY"
{
"task": {
"id": "424010985738629",
"model": "MiniMax-H3",
"status": "succeeded",
"created_at": 1785125529,
"updated_at": 1785125946,
"content": { "url": "https://cdn.h3.studio/outputs/...?Expires=…&Signature=…" },
"resolution": "768P",
"duration": 5,
"usage": {
"total_seconds": 5,
"input_seconds": 0,
"output_seconds": 5,
"input_image_count": 0
},
"ratio": "16:9",
"task_type": "generation",
"modality": "video"
}
}
status 依次经过 queued → running → succeeded。每几秒查一次即可，
也可以配 回调 彻底不轮询。
3. 下载
content.url 是一个签名链接，一小时后过期。它在每次查询时重新签发，
所以链接过期了再查一次就行。
curl -L "$URL" -o out.mp4
产物是 mp4：H.264 视频 24 fps，加一条 32 kHz 的 AAC 立体声轨。 音频是与画面在同一次前向里联合生成的 —— 不是事后配的音轨。
Python 写法
import os, time, httpx
api = httpx.Client(
base_url="https://api.h3.studio",
headers={"Authorization": f"Bearer {os.environ['H3_API_KEY']}"},
)
task_id = api.post("/v2/video_generation", json={
"model": "MiniMax-H3",
"content": [{"type": "text", "text": "黄昏时分礁岬上的灯塔"}],
"resolution": "768P",
"duration": 5,
"ratio": "16:9",
}).raise_for_status().json()["task_id"]
while True:
task = api.get(f"/v2/query/video_generation/{task_id}").json()["task"]
if task["status"] in ("succeeded", "failed", "cancelled"):
break
time.sleep(5)
if task["status"] != "succeeded":
raise RuntimeError(task.get("error"))
with open("out.mp4", "wb") as f:
f.write(httpx.get(task["content"]["url"], follow_redirects=True).content)
怎么写提示词才有效
H3 是用结构化提示词训练的，效果差别很明显。把画面、环境声、配乐分段写清楚， 比一句话强得多：
integrated_multimodal_description: [Shot 1] 电影感，缓慢推进。黄昏，一座孤零零的
灯塔立在礁石岬角上，塔灯在薄薄的海雾里旋转。脚下浪拍黑礁。
overall_soundscape: 持续的低沉浪涌声撞在礁石上。风掠过毫无遮挡的岬角。
一只海鸥叫了两声，又细又远。
non_diegetic_music: 缓慢、稀疏的钢琴动机，下面垫着持续的低音弦乐，
克制而不解决。
MiniMax 在 MiniMax-H3 仓库 里提供了可安装的提示词编写 skill，在这里同样适用。