MiniMax H3 异步视频 API
MiniMax H3 使用统一的 POST /v1/video/tasks 异步接口。当前公开模型为：
text
leonardo-minimax-h3-1440p模型固定输出 1440p，支持 5–15 秒、六种画幅、原生成片音轨、纯文本、首帧/尾帧、 最多五张普通图片参考，以及图片加音频参考。
能力摘要
| 能力 | 支持情况 |
|---|---|
| 文生视频 | 支持 |
| Start Frame | 支持，最多 1 张 |
| End Frame | 支持，最多 1 张且必须同时提供 Start Frame |
| 普通 Image Reference | 支持，最多 5 张，不能与首尾帧混用 |
| Video Reference | 不支持 |
| Audio Reference | media 模式支持 1–3 个，必须搭配 1–5 张普通图片 |
| 成片音轨 | 原生音轨始终开启；省略或传 true，显式 false 会被拒绝 |
| 输出分辨率 | 固定 1440p，不接受 output.resolution |
| 输出画幅 | 共 6 种：1:1、3:4、4:3、16:9、21:9、9:16；默认 16:9 |
私有生成
该模型由服务端以私有模式生成。调用者不需要也不能传 public；当前服务资源不具备私有生成权益时，任务会返回 private_generation_unavailable。
input.reference_audios 提供参考音频，output.generate_audio 描述成片音轨，两者相互独立。 H3 的成片音轨不能关闭；参考音频只在 media 模式中可用，不能与 frame 混用。
文档导航
| 页面 | 内容 |
|---|---|
| 异步任务与示例 | 文生视频、首尾帧、五图和图片加音频参考、查询与下载 |
| 参数与错误 | 字段、尺寸、数量限制和错误处理 |
| 视频 Webhook | 终态回调、签名验证和去重 |
最小请求
bash
curl -sS "$SUPERTOKEN_BASE_URL/v1/video/tasks" \
-H "Authorization: Bearer $SUPERTOKEN_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: h3-text-001" \
-d '{
"model": "leonardo-minimax-h3-1440p",
"operation": "generation",
"input": {
"prompt": "雨后的未来城市街道，镜头缓慢向前推进，电影感灯光"
},
"output": {
"duration": 5,
"aspect_ratio": "16:9",
"generate_audio": true
}
}'接口返回 202 Accepted。保存响应中的任务 id，使用资源 API Key 查询任务，或等待账号级 Webhook。