视频生成（海螺 H3）

视频生成是异步任务：提交后立刻拿到任务号，生成需要几分钟，之后用任务号查询结果。请求与响应沿用 MiniMax 官方 v2 接口的格式——按官方文档写好的代码，把 https://api.minimax.cn 换成本站地址加 /minimax、换用本站密钥即可。

提交任务#

curl https://本站域名/minimax/v2/video_generation \
-H "Authorization: Bearer sk-您的密钥" \
-H "Content-Type: application/json" \
-d '{
  "model": "MiniMax-H3",
  "resolution": "768P",
  "duration": 6,
  "content": [
    { "type": "text", "text": "清晨的海边灯塔，海浪拍打礁石，镜头缓慢推近" }
  ]
}'

成功时返回任务号：

{ "task_id": "424010985738629" }

content 的每一项：

素材地址只接受 http(s):// 链接或 data: 内联数据。

关闭 AI 生成标识后，请按国家有关规定自行对生成内容进行标识。

查询结果#

curl https://本站域名/minimax/v2/query/video_generation/424010985738629 \
-H "Authorization: Bearer sk-您的密钥"

{
  "task": {
    "id": "424010985738629",
    "status": "succeeded",
    "content": { "url": "https://…/output.mp4" },
    "usage": { "output_seconds": 6 }
  }
}

• 状态约每 15 秒更新一次，查询得更频繁不会更快出结果；
• 只能查到自己账号提交的任务，查不到时返回 404；
• 成片地址由上游提供，有有效期（上游未公布具体时长），拿到后请尽快下载保存，本站不转存。

也可以在控制台 · 生成任务查看每个任务的状态、费用和成片链接。

计费#

按生成视频的秒数计费，单价随分辨率不同，以模型广场为准：计价型号分别是 MiniMax-H3-768P、 MiniMax-H3-2K、MiniMax-H3-Max-480P、MiniMax-H3-Max-768P。

1. 提交时预扣：单价 × duration。余额不足返回 402、密钥额度不足返回 403，都不会提交给上游；
2. 成功后结算：按上游实际输出的秒数计费，与预扣额多退少补，计入费用明细；
3. 失败退回：生成失败、上游取消，或超过 24 小时仍没有结果，预扣全额退回。

提交请求本身失败（返回 4xx / 5xx）时不会扣费，可以稍后重试。

错误格式#

错误响应同样沿用 MiniMax v2 的形状：

{
  "type": "error",
  "error": { "type": "bad_request_error", "message": "MiniMax-H3 的 duration 须为 4–15 的整数秒", "http_code": "400" },
  "request_id": "…"
}