00-概述
MiniMax-H3 视频生成（V2） · 概述
文档版本：v1.0.0 | 最后更新：2026-08-13 本平台已完整适配 MiniMax 视频生成 V2（MiniMax-H3）官方接口，请求与响应均为透传，参数语义与官方一致。
能力简介
content 数组输入（文本 / 图片 / 视频 / 音频）创建视频生成任务，支持 768P / 2K 直出、4~15 秒时长，并提供 768P→2K 再生成与 H3-Context-IR 提示词增强两项配套能力：| 能力 | 文档 | 说明 |
|---|---|---|
| 视频生成 | 01-创建视频生成任务 | 文生视频、图生视频（首帧 / 尾帧 / 首尾帧）、多模态参考生视频 |
| 视频再生成 | 02-创建视频再生成任务 | 对 H3 768P 源视频再生成为 2K |
| H3-Context-IR | 03-创建H3-Context-IR任务 | 理解多模态上下文，生成结构化增强提示词（不生成视频） |
与海螺 V1 接口的关系：MiniMax-H3 使用独立的 V2 接口（路由前缀 /hailuo/v2/*），请求 / 响应结构与海螺（Hailuo）V1 接口（/hailuo/v1/*）完全不同，请勿混用。
接口一览
| 接口 | 方法 | 地址 |
|---|---|---|
| 创建视频生成任务 | POST | https://platform.shuyanai.com/hailuo/v2/video_generation |
| 创建视频再生成任务 | POST | https://platform.shuyanai.com/hailuo/v2/video_regeneration |
| 创建 H3-Context-IR 任务 | POST | https://platform.shuyanai.com/hailuo/v2/h3_context_ir |
| 查询任务 | GET | https://platform.shuyanai.com/hailuo/v2/query/video_generation/{task_id} |
| 查询任务列表 | GET | https://platform.shuyanai.com/hailuo/v2/query/video_generation |
| 取消或删除任务 | DELETE | https://platform.shuyanai.com/hailuo/v2/video_generation/{task_id} |
路径规则：在平台域名后追加渠道前缀 /hailuo，再拼接官方 V2 原始路径即可。
例如官方https://api.minimaxi.com/v2/video_generation→ 平台https://platform.shuyanai.com/hailuo/v2/video_generation。
标准调用流程
创建任务 (POST /hailuo/v2/video_generation | video_regeneration | h3_context_ir)
│ 返回 task_id
▼
查询任务 (GET /hailuo/v2/query/video_generation/{task_id}) ← 轮询直至 succeeded
│ 返回 content.url（视频任务）或 content.prompt（Context-IR 任务）
▼
下载 / 转存产物（下载链接有时效，请及时保存）鉴权
Authorization 头携带 Bearer 密钥进行鉴权：Authorization: Bearer {API_KEY}{API_KEY} 为您在平台控制台创建的接口密钥。请求头
| 头部 | 必填 | 说明 |
|---|---|---|
Authorization | 是 | Bearer {API_KEY} |
Content-Type | 是 | 固定为 application/json（创建任务接口） |
任务状态
| 状态 | 说明 |
|---|---|
queued | 排队中，可取消 |
running | 运行中 |
succeeded | 成功，可从 content 获取产物 |
failed | 失败，error 字段含错误码与原因 |
cancelled | 已取消 |
计 费与结算
| 计费项 | 刊例价 | 说明 |
|---|---|---|
| 视频生成 2K | 0.80 元/秒 | 按 usage.total_seconds 计（输入参考视频秒数 + 输出秒数，同价） |
| 视频生成 768P | 0.50 元/秒 | 同上 |
| 视频再生成（恒 2K） | 0.30 元/秒 | 按源视频实际时长计 |
| 输入图片超额（生成） | 0.20 元/张 | 每任务前 5 张免费，超出部分计费 |
| 输入图片超额（再生成） | 0.15 元/张 | 同上 |
| H3-Context-IR 输入 | 5.80 元/百万 tokens | 按 usage.prompt_tokens 计 |
| H3-Context-IR 输出 | 23.00 元/百万 tokens | 按 usage.completion_tokens 计 |
duration，再生成按 5 秒预估），任务成功后按查询接口返回的实际 usage 结算，多退少补。上表为刊例价，实际价格以您的商务协议与控制台计费页为准。
错误响应
{
"type": "error",
"error": {
"type": "bad_request_error",
"message": "invalid params, content must include a non-empty text item (prompt is required) (2013)",
"http_code": "400"
},
"request_id": "021785229015510a2c883cf675b9804d"
}error.message 结尾括号内为内部错误码。常见错误：| HTTP | error.type | 常见内部码 | 说明 |
|---|---|---|---|
| 400 | bad_request_error | 2013 | 参数错误（如 content 缺少非空 text） |
| 401 | authorized_error | 1004 / 2049 | 鉴权失败 / 密钥无效 |
| 402 | insufficient_balance_error | 1008 | 余额或额度不足 |
| 422 | unprocessable_entity_error | 1026 | 输入涉及敏感内容 |
| 429 | rate_limit_error | 1002 | 触发限流，请稍后重试 |
| 500 | server_error | 1000 | 服务端错误 |
相关文档
