# MiniMax H3 Max 视频 API

POST /api/v1/videos/generations

使用 Authorization: Bearer YOUR_API_KEY 和 Content-Type: application/json。每次新任务设置不同的 Idempotency-Key，超时重试保持原键和参数。

```json
{
  "modelId": "h3-max",
  "prompt": "海边的日落，镜头缓缓向前移动",
  "duration": 5,
  "imageSize": "768P",
  "aspectRatio": "16:9"
}
```



## 详细价格表

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 积分。1 美元 = 1 API 积分，支持小数。API 独立钱包和售价，不使用网站会员折扣。

分辨率：480P / 768P；比例：1:1 / 9:16 / 16:9 / 3:4 / 4:3 / 21:9；时长：5–15 秒，步长 1 秒。

参考图生视频：referenceUrls 为可公开访问的图片 URL 数组，videoInputMode 为 keyframes；图片数量与输入模式由模型能力校验。该模型不支持参考视频或音频。

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

首尾帧可通过 keyframePositions 标记角色，与 referenceUrls 一一对应；单独尾帧使用 ["last_frame"]。文生视频使用固定比例，首尾帧跟随图片方向，参考图模式可选 adaptive。

POST /api/v1/videos/quote 使用相同参数，返回 estimatedPoints，不冻结积分。提交成功返回 HTTP 202 和 taskId，冻结 API 积分。

GET /api/v1/tasks/{taskId} 查询状态，成功结果在 task.videos[].url，携带密钥请求本站相对路径下载。视频遵循本站保存期限，请及时下载；过期返回 410。settled 为 true 时 chargedPoints 为最终扣费。失败结算遵循模型规则。