视频生成 · API v1

MiniMax H3 Max 视频 API

通过文字或参考图片生成视频，使用独立 API 积分。

POST/api/v1/videos/generations

模型与参数

modelId

h3-max

prompt

视频画面描述，必填

duration

5–15 秒，步长 1；默认 5 秒

imageSize

480P / 768P

aspectRatio

1:1 / 9:16 / 16:9 / 3:4 / 4:3 / 21:9

referenceUrls

可选，公开图片 URL 数组；不支持参考视频或参考音频

videoInputMode

keyframes；默认 keyframes

keyframePositions

可选，首尾帧角色数组，与 referenceUrls 一一对应。单独尾帧传 ["last_frame"]；首尾帧传 ["first_frame","last_frame"]。

referenceImageOrder

可选，图片顺序数组；每项为 url: 加对应 referenceUrls 中的完整地址，必须恰好覆盖全部参考图片

每次输出一个视频。参考图片数量、首尾帧和参考图模式以模型支持能力为准；不支持的组合会返回参数错误。

报价与 API 积分

详细价格表

22 个价格档位

MiniMax H3 Max API 调用价格
分辨率	时长	API 积分 / 次
480P	5 秒	0.3
480P	6 秒	0.36
480P	7 秒	0.42
480P	8 秒	0.48
480P	9 秒	0.54
480P	10 秒	0.6
480P	11 秒	0.66
480P	12 秒	0.72
480P	13 秒	0.78
480P	14 秒	0.84
480P	15 秒	0.9
768P	5 秒	0.475
768P	6 秒	0.57
768P	7 秒	0.665
768P	8 秒	0.76
768P	9 秒	0.855
768P	10 秒	0.95
768P	11 秒	1.045
768P	12 秒	1.14
768P	13 秒	1.235
768P	14 秒	1.33
768P	15 秒	1.425

1 美元 = 1 API 积分。售价最多保留 4 位小数；表内为不含参考媒体及附加选项的单个视频售价。

参考视频、参考音频、参考图片及模型支持的附加选项可能影响费用；请向报价接口提交完整参数，以返回的报价为准。

默认配置：每次 0.475 API 积分（5 秒）。向 POST /api/v1/videos/quote 提交相同参数查询 estimatedPoints；报价不创建任务，也不冻结积分。分辨率、时长、声音与快速模式可能影响价格。

1 美元 = 1 API 积分，支持小数。API 钱包和价格独立，不享受网站会员折扣。提交时冻结 API 积分，任务结束后按模型规则结算。充值 API 积分

查询与下载视频

成功提交返回 HTTP 202 和 taskId。每 3–5 秒请求 GET /api/v1/tasks/{taskId}，queued 和 processing 状态继续等待；succeeded、partial、failed 状态停止轮询。settled 为 true 时，chargedPoints 是最终扣费。

task.videos[].url 是本站视频下载路径，下载也必须携带 API Key。视频遵循本站保留期限，过期返回 410，请及时下载保存。只能访问本人 API 任务。

幂等重试

每个新任务设置不同的 Idempotency-Key，8–128 位字母、数字或 ._:-。超时重试保持相同键和参数，避免重复冻结；改变参数返回 409。有效密钥不设请求频率和网页会员并发上限。

错误处理

400 参数或报价组合无效；401 密钥无效；402 API 积分不足；404 任务不存在或无权访问；409 幂等冲突；410 视频已过期；5xx 服务暂不可用。错误包含 error 和 code，不返回内部调用信息。