MiniMax-H3 创建视频生成任务

通过多模态 content 数组输入（文本 / 图片 / 视频 / 音频），支持文生视频、图生视频（首尾帧）、多模态参考生视频。提供 MiniMax/MiniMax-H3（支持 2K 直出）与 MiniMax/MiniMax-H3-Max（超快生成，最高 768P）两个模型。

接口地址

http

POST /minimax/v2/video_generation

请求头

参数名	类型	必填	默认值	说明
`Content-Type`	string	是	`application/json`	请求体媒介类型
`Authorization`	string	是	-	鉴权信息，格式为 `Bearer <API_KEY>`

请求体

参数名	类型	必填	说明
`model`	string	是	模型名称。可用值：`MiniMax/MiniMax-H3`、`MiniMax/MiniMax-H3-Max`，能力差异见模型能力对比
`content`	object[]	是	多模态输入内容数组，每个元素通过 `type` 区分类型，`role` 标注用途
`resolution`	string	是	视频分辨率。可用值：`480P`、`768P`、`2K`，各模型支持范围不同，见模型能力对比
`duration`	integer	是	生成视频时长（秒）。`MiniMax/MiniMax-H3` 支持 4~15 的整数；`MiniMax/MiniMax-H3-Max` 支持 5~15 的整数（不支持 4 秒）
`ratio`	string	否	生成视频宽高比，默认 `adaptive`。可用值：`adaptive`、`21:9`、`16:9`、`4:3`、`1:1`、`3:4`、`9:16`
`extra`	object	否	额外生成选项，仅 `MiniMax/MiniMax-H3-Max` 支持，详见 extra 参数说明
`callback_url`	string	否	任务状态变更的回调通知地址
`aigc_watermark`	boolean	否	是否添加 AIGC 标识水印，默认 `false`

模型能力对比

能力	`MiniMax/MiniMax-H3`	`MiniMax/MiniMax-H3-Max`
定位	通用高质量生成	超快生成版本
分辨率	`768P`、`2K`	`480P`、`768P`（默认 `768P`，不支持 `2K`）
时长	4~15 s	5~15 s（不支持 4 s）
文生视频	支持	支持
图生视频（首帧 / 尾帧 / 首尾帧）	支持	支持
多模态参考生视频（参考图 / 参考视频 / 参考音频）	支持	支持
`extra` 扩展参数	不支持	支持

两个模型的 content 元素类型、role 用途、输入组合与互斥规则完全一致，可按下文说明通用。

content 元素说明

每次请求必须包含一个非空 text 项（prompt 必填），缺失会返回参数错误。

支持的输入组合

场景	组合方式
文生视频	仅一个 `text` 元素
图生视频-首帧	`text` + 1 张 `image_url`（role=`first_frame` 或不填）
图生视频-尾帧	`text` + 1 张 `image_url`（role=`last_frame`）
图生视频-首尾帧	`text` + 2 张 `image_url`（role 分别为 `first_frame`、`last_frame`）
多模态参考生视频	`text` + 参考图片（role=`reference_image`）+ 参考视频（role=`reference_video`）+ 参考音频（role=`reference_audio`）的组合

互斥规则：图生视频与多模态参考生视频互斥。content 中出现 reference_image / reference_video / reference_audio 任一 role，就不能再出现 first_frame / last_frame（反之亦然）。

输入媒体限制

请求体总大小 ≤ 64 MB，大文件请用公网 URL，勿用 Base64。
输入素材也可先通过文件上传接口上传，再以 mm_file://{file_id} 形式在 url 字段中引用。

图片（image_url）

限制项	详情
格式	JPG、JPEG、PNG、WEBP、HEIC、HEIF
单文件大小	≤ 30 MB
宽高范围	[256, 5760] px
长宽比（宽/高）	[0.4, 2.5]
数量	首帧 ≤ 1、尾帧 ≤ 1、参考图 ≤ 9

视频（video_url，仅多模态参考场景）

限制项	详情
容器/格式	MP4（.mp4）、MOV（.mov）
编码	视频 H.264/AVC、H.265/HEVC；音频 AAC、MP3
单文件大小	≤ 50 MB
个数	≤ 3
单段时长	[2, 15] s；总时长 ≤ 15 s
宽高范围	[256, 5760] px
长宽比（宽/高）	[0.4, 2.5]
帧率	[23.976, 60]

音频（audio_url，仅多模态参考场景）

限制项	详情
格式	WAV、MP3
单文件大小	≤ 15 MB
个数	≤ 3
单段时长	[2, 15] s；总时长 ≤ 15 s

ratio 参数说明

场景	ratio 行为
文生视频（content 仅含 text）	ratio 必填，且不能为 `adaptive`
图生视频（含 first_frame / last_frame 图片）	宽高比由输入图片决定，恒为 `adaptive`，传入其他值会被忽略
多模态参考生视频	ratio 可选，默认 `adaptive`，也可显式指定具体比例

extra 参数说明

extra 是 MiniMax/MiniMax-H3-Max 专属的额外生成选项，MiniMax/MiniMax-H3 不支持。当前仅支持 prompt_expansion_mode 一个属性：

字段	类型	必填	默认值	说明
`extra.prompt_expansion_mode`	string	否	`balanced`	提示词扩写模式。`disabled`：关闭提示词扩写；`balanced`：均衡扩写；`quality`：质量优先扩写

不传 extra，或 extra 中不传该属性时，默认按 balanced 处理。
请勿传入 balance（注意与 balanced 的拼写差异）、空字符串、布尔值或其他未声明的字段，否则会因参数校验失败返回 400。

callback_url 回调说明

配置后 MiniMax 服务器会：

先发送含 challenge 字段的验证请求（需 3 秒内原样返回 challenge 完成验证）
验证成功后，每当任务状态变更即向该地址 POST 推送，推送体结构与查询任务接口响应一致

回调 status 取值：queued（排队中）、running（运行中）、succeeded（成功）、failed（失败）、cancelled（已取消）

请求示例

bash

# 文生视频（t2va）
curl --request POST \
  --url https://neolink.com/api/minimax/v2/video_generation \
  --header 'Authorization: Bearer <API_KEY>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "MiniMax/MiniMax-H3",
    "content": [
      {
        "type": "text",
        "text": "史诗级太空歌剧院线预告：女舰长独自站在巨大观景窗前，最后一支舰队正在集结并跃迁离去，强光爆闪、舰桥震动，她被留在原地。"
      }
    ],
    "resolution": "2K",
    "duration": 5,
    "ratio": "16:9"
  }'

# 文生视频（t2va）- MiniMax-H3-Max
curl --request POST \
  --url https://neolink.com/api/minimax/v2/video_generation \
  --header 'Authorization: Bearer <API_KEY>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "MiniMax/MiniMax-H3-Max",
    "content": [
      {
        "type": "text",
        "text": "史诗级太空歌剧院线预告：女舰长独自站在巨大观景窗前，最后一支舰队正在集结并跃迁离去，强光爆闪、舰桥震动，她被留在原地。"
      }
    ],
    "resolution": "768P",
    "duration": 5,
    "ratio": "16:9",
    "extra": {
      "prompt_expansion_mode": "balanced"
    }
  }'

# 图生视频（i2va）
curl --request POST \
  --url https://neolink.com/api/minimax/v2/video_generation \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "MiniMax/MiniMax-H3",
  "content": [
    {
      "type": "text",
      "text": "Pull focus to the people in the background and add more steam to the ramen bowl."
    },
    {
      "type": "image_url",
      "image_url": {
        "url": "https://cdn.hailuoai.com/prod/hailuo_demo/testsets/H3_AA_I2VA/gallery/sr_v17_variants_seed42_43_20260724/inputs/4a3a90bf9100_KDmcbkhzYo5sjjxr9FqcVmWVnzb.png"
      },
      "role": "first_frame"
    }
  ],
  "resolution": "2K",
  "duration": 5,
  "ratio": "adaptive"
}
'
# 多模态参考生视频（r2va）
curl --request POST \
  --url https://neolink.com/api/minimax/v2/video_generation \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "MiniMax/MiniMax-H3",
  "content": [
    {
      "type": "text",
      "text": "角色说话：Follow the wind, live free.Leave worries behind, enjoy the moment，音色参考音频1"
    },
    {
      "type": "video_url",
      "video_url": {
        "url": "https://cdn.hailuoai.com/prod/hailuo_demo/testsets/h3_promo_eval_ref2va/gallery/sr_v2p26_trio_seed42_20260724/inputs/297573323635_00_%E8%A7%86%E9%A2%911_YnyRbxEwio_video_20260525_163755_1927e9d3.mp4"
      },
      "role": "reference_video"
    },
    {
      "type": "audio_url",
      "audio_url": {
        "url": "https://cdn.hailuoai.com/prod/hailuo_demo/testsets/h3_promo_eval_ref2va/gallery/sr_v2p26_trio_seed42_20260724/inputs/f463d523c5ce_01_%E9%9F%B3%E9%A2%911_RSLcbpzJPo_6%E6%9C%885%E6%97%A5(1).mp3"
      },
      "role": "reference_audio"
    }
  ],
  "resolution": "2K",
  "duration": 5,
  "ratio": "adaptive"
}
'

成功响应（HTTP 200）

json

{
  "task_id": "424010985738629"
}

字段	类型	说明
`task_id`	string	任务 ID，用于后续查询任务状态与结果

错误响应

HTTP 状态码	错误类型	错误码	说明
400	`bad_request_error`	2013	参数无效，content 必须包含非空 text 项
401	`authorized_error`	1004	认证失败
402	`insufficient_balance_error`	1008	余额不足
422	`unprocessable_entity_error`	1026	视频描述包含敏感内容
429	`rate_limit_error`	1002	速率限制，请稍后重试
500	`server_error`	1000	内部错误

MiniMax/hailuo

MiniMax-H3

MiniMax

Suno

OpenAI 兼容接口

Seedance资源管理

MiniMax-H3 创建视频生成任务

接口地址

请求头

请求体

模型能力对比

content 元素说明

支持的输入组合

输入媒体限制

图片（image_url）

视频（video_url，仅多模态参考场景）

音频（audio_url，仅多模态参考场景）

ratio 参数说明

extra 参数说明

callback_url 回调说明

请求示例

成功响应（HTTP 200）

错误响应

MiniMax/hailuo

MiniMax-H3

MiniMax

Suno

OpenAI 兼容接口

Seedance资源管理

MiniMax-H3 创建视频生成任务 ​

接口地址 ​

请求头 ​

请求体 ​

模型能力对比 ​

content 元素说明 ​

支持的输入组合 ​

输入媒体限制 ​

图片（image_url） ​

视频（video_url，仅多模态参考场景） ​

音频（audio_url，仅多模态参考场景） ​

ratio 参数说明 ​

extra 参数说明 ​

callback_url 回调说明 ​

请求示例 ​

成功响应（HTTP 200） ​

错误响应 ​

MiniMax-H3 创建视频生成任务

接口地址

请求头

请求体

模型能力对比

content 元素说明

支持的输入组合

输入媒体限制

图片（image_url）

视频（video_url，仅多模态参考场景）

音频（audio_url，仅多模态参考场景）

ratio 参数说明

extra 参数说明

callback_url 回调说明

请求示例

成功响应（HTTP 200）

错误响应