# MiniMax H3 视频 API

POST /api/v1/videos/generations

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

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



## 详细价格表

MiniMax H3 API 调用价格

| 分辨率 | 时长 | API 积分 / 次 |
| --- | --- | --- |
| 768P | 4 秒 | 0.4 |
| 768P | 5 秒 | 0.5 |
| 768P | 6 秒 | 0.6 |
| 768P | 7 秒 | 0.7 |
| 768P | 8 秒 | 0.8 |
| 768P | 9 秒 | 0.9 |
| 768P | 10 秒 | 1 |
| 768P | 11 秒 | 1.1 |
| 768P | 12 秒 | 1.2 |
| 768P | 13 秒 | 1.3 |
| 768P | 14 秒 | 1.4 |
| 768P | 15 秒 | 1.5 |
| 2K | 4 秒 | 0.65 |
| 2K | 5 秒 | 0.8125 |
| 2K | 6 秒 | 0.975 |
| 2K | 7 秒 | 1.1375 |
| 2K | 8 秒 | 1.3 |
| 2K | 9 秒 | 1.4625 |
| 2K | 10 秒 | 1.625 |
| 2K | 11 秒 | 1.7875 |
| 2K | 12 秒 | 1.95 |
| 2K | 13 秒 | 2.1125 |
| 2K | 14 秒 | 2.275 |
| 2K | 15 秒 | 2.4375 |

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

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

前 5 张参考图片免费，之后每张附加费约 0.045 API 积分；最终总价以完整参数报价为准。

参考视频按检测到的输入总时长向上取整后，与输出时长一起计费；参考音频免费，但不能单独使用。


默认配置每次 0.5 API 积分。1 美元 = 1 API 积分，支持小数。API 独立钱包和售价，不使用网站会员折扣。

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

参考图生视频：referenceUrls 为可公开访问的图片 URL 数组，videoInputMode 为 keyframes / references；图片数量与输入模式由模型能力校验。多模态参考：referenceVideoUrls、referenceAudioUrls 为公开 HTTP(S) URL 数组，各最多 3 段，videoInputMode 使用 references（提供参考视频或音频时也可省略，系统会自动选择）。视频支持 MP4/MOV、H.264/H.265 编码、AAC/MP3 音轨，每段不超过 50MB、2–15 秒，合计最多 15 秒；画面每边 256–5760 像素，宽高比 0.4–2.5，帧率 23.976–60。音频支持 MP3/WAV，每段不超过 15MB、2–15 秒，合计最多 15 秒，必须搭配图片或视频。不得与 keyframePositions 或首尾帧模式混用。时长由服务端检测，不接受客户端上报；首次报价会导入并检测素材，后续请求复用已检测素材。

其他可用参数：
- 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 为最终扣费。失败结算遵循模型规则。