MiniMax H3 视频生成
MiniMax H3 系列走 MiniMax 原生异步接口(/api/v2),与火山 Seedance 形态(/api/v3)并存。两者都是「创建任务 → 轮询状态 → 取结果」,区别在路径、字段名和计费方式。
MiniMax 视频按秒计费(不同分辨率每秒单价不同),不是按 token。
模型与分辨率
H3 系列各变体支持的分辨率不同,实际可用档位以模型详情页定价为准:
| 模型 | 支持分辨率 | 说明 |
|---|---|---|
| MiniMax-H3 | 768P / 2K | 标准档,支持 2K |
| H3-Highspeed | 480P / 768P | 速度优先 |
| H3-Lite | 480P / 768P | 成本优先 |
| H3-Max | 480P / 768P | 质量优先,最短 5 秒 |
传入模型不支持的 resolution 会直接返回 400,不会提交到上游。
关键参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
model | string | 是 | 模型调用名,从模型广场或模型列表获取 |
content | array | 是 | 输入内容,必须含至少一个非空 text 项 |
resolution | string | 是 | 768P / 2K 或 480P / 768P,取决于模型 |
duration | integer | 是 | 输出时长(秒),4~15(H3-Max 最短 5) |
ratio | string | 条件 | adaptive / 21:9 / 16:9 / 4:3 / 1:1 / 3:4 / 9:16;文生视频必填且不能 adaptive |
callback_url | string | 否 | 任务终态回调地址(平台在任务完成时 POST 结果到该地址) |
aigc_watermark | boolean | 否 | 是否加水印,默认 false |
content 元素
| 字段 | 类型 | 说明 |
|---|---|---|
type | string | text / image_url / video_url / audio_url |
text | string | type=text 时必填 |
image_url.url | string | 公网 URL |
role | string | first_frame / last_frame / reference_image / reference_video / reference_audio |
首尾帧(
first_frame+last_frame)与参考生(reference_*)不能混用。
接口一览
| 操作 | 方法 | 路径 |
|---|---|---|
| 创建任务 | POST | /api/v2/video_generation |
| 查询任务 | GET | /api/v2/query/video_generation/{task_id} |
| 任务列表 | GET | /api/v2/query/video_generation |
| 取消/删除 | DELETE | /api/v2/video_generation/{task_id} |
任务状态:queued → running → succeeded / failed / cancelled。
文生视频
curl -X POST https://www.silvamux.com/api/v2/video_generation \
-H "Authorization: Bearer $SILVAMUX_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "<MODEL_CALL_NAME>",
"content": [{"type": "text", "text": "一只金毛犬在海滩上奔跑,电影感"}],
"resolution": "768P",
"duration": 5,
"ratio": "16:9"
}'
创建成功返回:
{"task_id": "462160194171102"}
查询任务
curl "https://www.silvamux.com/api/v2/query/video_generation/<TASK_ID>" \
-H "Authorization: Bearer $SILVAMUX_API_KEY"
成功时响应包一层 task:
{
"task": {
"id": "462160194171102",
"model": "<MODEL_CALL_NAME>",
"status": "succeeded",
"resolution": "768P",
"duration": 5,
"content": { "url": "https://..." },
"usage": { "total_seconds": 5, "output_seconds": 5 }
}
}
- 产物地址在
task.content.url,有时效,成功后请尽快下载。 - 计费秒数在
task.usage.total_seconds。
首帧图生 / 参考生
{
"model": "<MODEL_CALL_NAME>",
"content": [
{"type": "text", "text": "镜头缓缓拉远,蒸汽增多"},
{
"type": "image_url",
"image_url": {"url": "https://example.com/first.png"},
"role": "first_frame"
}
],
"resolution": "2K",
"duration": 5,
"ratio": "adaptive"
}
参考生(reference_image / reference_video / reference_audio)最多 9 图、3 视频、3 音频,音频不能单独出现。
取消任务
curl -X DELETE "https://www.silvamux.com/api/v2/video_generation/<TASK_ID>" \
-H "Authorization: Bearer $SILVAMUX_API_KEY"
queued 状态的任务取消不收费用(预扣金额全额退回)。已进入 running 的任务上游不允许取消。
结果回调
传入 callback_url 后,任务进入终态时平台会向该地址 POST 结果,body 与查询接口同构({"task": {...}})。
用户的回调地址由平台代理接收后再转发,不需要实现 MiniMax 官方的 challenge 握手。
未传 callback_url 时可自行轮询查询接口,平台内部也有轮询兜底。
计费
按输出视频秒数计费,每秒单价因分辨率档位而异。例:
- 768P 5 秒 × 单价
- 2K 5 秒 × 单价(更高档位)
实际单价见模型详情页价格表或控制台定价页。
与火山 Seedance 的区别
| 项 | MiniMax H3 | 火山 Seedance |
|---|---|---|
| 创建路径 | /api/v2/video_generation | /api/v3/contents/generations/tasks |
| 创建响应 | {"task_id": ...} | {"id": ...} |
| 查询响应 | {"task": {...}} | 裸任务对象 |
| 产物字段 | task.content.url | content.video_url |
| 计费 | 按秒(分辨率分档) | 按 token |
两套接口并存,任务彼此隔离:/api/v3 的任务列表不含 MiniMax 任务,反之亦然。