MiniMax-H3 视频生成

MiniMax-H3 的 4–15 秒视频生成、768P/2K 清晰度和多参考素材接口

MiniMax-H3 使用统一异步任务接口 /v1/task/submit 提交视频任务，支持文生视频、参考图、参考视频、参考音频。视频时长 4–15 秒，清晰度支持 768P 和 2K。

请求格式

所有生成参数都必须放在 input 对象中。模型名区分大小写，请使用 MiniMax-H3。

快速了解

项目	支持范围
任务流程	`POST /v1/task/submit` 提交，`GET /v1/task/{task_id}` 查询
视频时长	4–15 秒，默认 5 秒
清晰度	`768P`、`2K`，默认 `768P`
画面比例	`21:9`、`16:9`、`4:3`、`3:2`、`2:3`、`1:1`、`3:4`、`9:16`
参考图	最多 9 张
参考视频	最多 3 条
参考音频	最多 3 条，可单独使用
生成数量	固定 `n = 1`

不传参考图为文生视频；传入参考图自动走图生视频。参考图、参考视频、参考音频可按需组合。

接口概览

能力	方法	路径
提交任务	`POST`	`/v1/task/submit`
查询任务	`GET`	`/v1/task/{task_id}`

所有接口都使用 Bearer 认证：

Authorization: Bearer $API_KEY

input 参数

请求体中的 model 固定为 MiniMax-H3，以下生成参数统一放在必填的 input 对象中。

字段	类型	必填	说明
`prompt`	string	是	视频提示词，建议描述主体、动作、场景和镜头
`duration`	integer	否	视频时长，4–15 秒，默认 `5`
`aspect_ratio`	string	否	`21:9`、`16:9`、`4:3`、`3:2`、`2:3`、`1:1`、`3:4`、`9:16`，默认 `16:9`
`resolution`	string	否	仅支持 `768P` 或 `2K`，默认 `768P`
`prompt_enhance`	boolean	否	是否增强提示词，默认 `false`
`image_references`	array	否	参考图，最多 9 张
`video_references`	array	否	参考视频，最多 3 条
`audio_references`	array	否	参考音频，最多 3 条
`n`	integer	否	生成数量，当前只支持 `1`

数组项可以是 URL 字符串，或 { "url": "https://..." }。请使用公网 http(s) URL。

清晰度与输出尺寸

`resolution`	说明
`768P`	默认。适合成本和速度优先
`2K`	更高清晰度

aspect_ratio	768P	2K
`21:9`	`1568x672`	`2208x960`
`16:9`	`1376x768`	`1920x1088`
`4:3`	`1184x896`	`1664x1248`
`3:2`	`1248x832`	`1760x1184`
`1:1`	`1024x1024`	`1440x1440`
`2:3`	`832x1248`	`1184x1760`
`3:4`	`896x1184`	`1248x1664`
`9:16`	`768x1376`	`1088x1920`

输出画布按 32 像素对齐，因此 16:9 + 2K 的实际文件可能是 1920x1088，这是正常输出。

素材组合规则

组合	是否支持	说明
纯文生视频	支持	不传任何参考素材
参考图	支持	最多 9 张
参考音频	支持	可单独使用，也可和参考图一起用
参考视频	支持	最多 3 条
参考图 + 参考视频 + 参考音频	支持	可组合使用

提交任务

curl https://cdn.12ai.org/v1/task/submit \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "MiniMax-H3",
    "input": {
      "prompt": "一位身穿红色连衣裙的舞者在明亮舞台上自然起舞，镜头平稳推进，电影级光影",
      "aspect_ratio": "16:9",
      "resolution": "2K",
      "duration": 10
    }
  }'

curl https://cdn.12ai.org/v1/task/submit \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "MiniMax-H3",
    "input": {
      "prompt": "让参考图中的角色跟随音乐自然跳舞，保持人物外观和服装一致",
      "image_references": [
        {"url": "https://example.com/character.jpg"}
      ],
      "audio_references": [
        {"url": "https://example.com/music.mp3"}
      ],
      "aspect_ratio": "16:9",
      "resolution": "2K",
      "duration": 10
    }
  }'

curl https://cdn.12ai.org/v1/task/submit \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "MiniMax-H3",
    "input": {
      "prompt": "参考人物动作生成一段舞台舞蹈视频",
      "video_references": [
        "https://example.com/motion.mp4"
      ],
      "aspect_ratio": "16:9",
      "resolution": "768P",
      "duration": 10
    }
  }'

提交响应

提交成功后保存返回的 id：

{
  "id": "task_xxxxxxxxx",
  "status": "queued",
  "phase": "queued",
  "created_at": 1785542400
}

查询任务

curl https://cdn.12ai.org/v1/task/task_xxxxxxxxx \
  -H "Authorization: Bearer $API_KEY"

`status`	含义
`queued`	排队中
`in_progress`	生成中
`completed`	完成，结果在 `outputs`
`failed`	失败，见 `error`

任务完成后，从 outputs 数组读取视频 URL：

{
  "id": "task_xxxxxxxxx",
  "status": "completed",
  "phase": "completed",
  "outputs": [
    "https://img.12ai.org/videos/task_xxxxxxxxx_0.mp4"
  ]
}

建议间隔 5 秒轮询，直到 completed 或 failed。进入终态后停止轮询。

使用建议

场景	建议
常规成片	`resolution` 用 `2K`，`duration` 先从 5 或 10 秒测
成本/速度优先	改用 `768P`
指定人物或产品外观	传 `image_references`
跟随节奏或配乐	传 `audio_references`
参考动作	传 `video_references`

MiniMax-H3 视频生成

On this page