MiniMax H3 视频生成

AionRouter 支持 MiniMax-H3 和 MiniMax-H3-Max。这两个模型都使用统一视频任务接口。

模型	适用输入
`MiniMax-H3`	文本、首尾帧，以及模型允许的参考图片、视频或音频。
`MiniMax-H3-Max`	文本和首尾帧。不要为该模型发送参考图片、视频或音频。

能力与选择

MiniMax-H3 支持三种输入模式。Router 会根据你传入的媒体判断生成模式。

模式	输入方式	规则
文生视频	仅 `prompt`	默认画幅为 `16:9`。
首尾帧生成	顶层 `images`，或 `metadata.first_frame_image` / `last_frame_image`	最多 2 张图，第一张为首帧，第二张为尾帧。
参考生视频	`metadata.reference_image`、`reference_video` 或 `reference_audio`，也可用 `metadata.content`	最多 9 张参考图、3 段参考视频和 3 段参考音频。

不要在同一请求中混用首尾帧与参考素材。MiniMax-H3-Max 不支持任何参考图、参考视频或参考音频。

请求头

Header	必填	说明
`Authorization`	是	`Bearer <API_KEY>`。
`Content-Type`	是	`application/json`。

请求体字段

字段	类型	必填	说明
`model`	string	是	`MiniMax-H3` 或 `MiniMax-H3-Max`。
`prompt`	string	是	顶层文本提示词。当前公共接口会在适配器处理前校验此字段；即使 `metadata.content` 中包含 `text` 项也必须提供。
`duration`	integer	否	H3 为 4–15，H3 Max 为 5–15；默认 5。
`seconds`	string	否	`duration` 的兼容字段；两个字段同时传入时数值必须一致。
`size`	string	否	分辨率兼容字段。H3 支持 `768P`、`2K`；H3 Max 支持 `480P`、`768P`。
`images`	string[]	首尾帧模式时必填	最多两张，第一张是首帧，第二张是尾帧。
`metadata`	object	否	传递 `resolution`、`ratio`、首尾帧、参考素材或完整 `content` 数组。

参数范围

字段	`MiniMax-H3`	`MiniMax-H3-Max`
`duration` 或 `seconds`	4–15 秒	5–15 秒
`metadata.resolution` 或 `size`	`768P` 或 `2K`	`480P` 或 `768P`
`metadata.ratio`	`adaptive`、`21:9`、`16:9`、`4:3`、`1:1`、`3:4`、`9:16`	相同

使用媒体时，未传 ratio 会默认 adaptive；纯文本请求默认 16:9。adaptive 必须搭配图片或视频输入。

`metadata.content` 项

字段	类型	必填	说明
`type`	string	是	`text`、`image_url`、`video_url` 或 `audio_url`。
`text`	string	`type=text` 时必填	提示词文本。
`image_url.url`	string	`type=image_url` 时必填	图片 URL。角色为 `first_frame`、`last_frame` 或 `reference_image`。
`video_url.url`	string	`type=video_url` 时必填	参考视频 URL；角色只能是 `reference_video`。
`audio_url.url`	string	`type=audio_url` 时必填	参考音频 URL；角色只能是 `reference_audio`。
`role`	string	媒体项时条件必填	指定媒体角色。首尾帧不能与任何参考素材混用。

完整调用示例

以下示例使用统一任务接口。提交响应、查询响应和状态字段的完整说明见异步任务工作流。

文生视频

# 1. 提交任务
curl -X POST "https://router.aionclaw.ai/v1/video/generations" \
  -H "Authorization: Bearer $AIONROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "MiniMax-H3",
    "prompt": "一只橘猫在阳光下打盹，微风吹动毛发，镜头缓慢推近",
    "duration": 6,
    "metadata": {
      "resolution": "2K",
      "ratio": "16:9"
    }
  }'

提交成功后，保存响应中的 id：

{
  "id": "task_01HZX7Q8K6P3Y4M2N9R5T1V0AB",
  "task_id": "task_01HZX7Q8K6P3Y4M2N9R5T1V0AB",
  "object": "video",
  "model": "MiniMax-H3",
  "status": "queued",
  "progress": 0,
  "created_at": 1780000000
}

首尾帧图生视频

使用 images 传图。第一张是首帧，第二张是尾帧。图生时不传 metadata.ratio 会自动使用 adaptive，跟随输入画面比例。

curl -X POST "https://router.aionclaw.ai/v1/video/generations" \
  -H "Authorization: Bearer $AIONROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "MiniMax-H3",
    "prompt": "镜头从首帧的城市天台平滑推进到尾帧的日落夜景，人物自然转身看向远方",
    "duration": 6,
    "images": [
      "https://example.com/first-frame.jpg",
      "https://example.com/last-frame.jpg"
    ],
    "metadata": {
      "resolution": "2K"
    }
  }'

参考图生视频

MiniMax-H3 可传参考图片、参考视频或参考音频。若要精确指定素材角色，请使用 metadata.content；参考素材不能与首尾帧混用。

curl -X POST "https://router.aionclaw.ai/v1/video/generations" \
  -H "Authorization: Bearer $AIONROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "MiniMax-H3",
    "prompt": "保持参考角色的服装和画风，在雨后的街道上缓慢行走，电影级跟拍镜头",
    "duration": 6,
    "metadata": {
      "resolution": "2K",
      "ratio": "16:9",
      "content": [
        {
          "type": "image_url",
          "role": "reference_image",
          "image_url": { "url": "https://example.com/character.jpg" }
        }
      ]
    }
  }'

查询并下载

# 2. 查询。data.status 为 SUCCESS 时任务完成。
curl "https://router.aionclaw.ai/v1/video/generations/task_01HZX7Q8K6P3Y4M2N9R5T1V0AB" \
  -H "Authorization: Bearer $AIONROUTER_API_KEY"

# 3. 下载视频。
curl -L "https://router.aionclaw.ai/v1/videos/task_01HZX7Q8K6P3Y4M2N9R5T1V0AB/content" \
  -H "Authorization: Bearer $AIONROUTER_API_KEY" \
  --output minimax-h3.mp4

H3 Max 示例

curl -X POST "https://router.aionclaw.ai/v1/video/generations" \
  -H "Authorization: Bearer $AIONROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "MiniMax-H3-Max",
    "prompt": "A paper kite flying above a coastal village",
    "duration": 5,
    "metadata": {
      "resolution": "480P",
      "ratio": "16:9"
    }
  }'

输入规则

首尾帧模式不能与参考素材模式混用。对于 H3 Max，不要发送参考素材。Router 会校验部分不支持的组合，但你应在发送请求前按模型规则选择输入。分辨率和时长限制因模型而异。以列出模型和实际请求响应为准。

参考生示例

curl -X POST "https://router.aionclaw.ai/v1/video/generations" \
  -H "Authorization: Bearer $AIONROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "MiniMax-H3",
    "prompt": "Use the character and mood of the reference image in a slow tracking shot.",
    "duration": 6,
    "metadata": {
      "resolution": "2K",
      "ratio": "16:9",
      "reference_image": ["https://example.com/character.png"]
    }
  }'

如需精确指定素材角色，使用 metadata.content。其中 image_url 的角色是 first_frame、last_frame 或 reference_image；video_url 只能是 reference_video，audio_url 只能是 reference_audio。

当前 AionRouter H3 适配器不使用顶层 input_reference 或 media 字段。请改用 images 传首尾帧，或用 metadata.content 传参考图片、视频和音频。

​能力与选择

​请求头

​请求体字段

​参数范围

​metadata.content 项

​完整调用示例

​文生视频

​首尾帧图生视频

​参考图生视频

​查询并下载

​H3 Max 示例

​输入规则

​参考生示例

能力与选择

请求头

请求体字段

参数范围

`metadata.content` 项

完整调用示例

文生视频

首尾帧图生视频

参考图生视频

查询并下载

H3 Max 示例

输入规则

参考生示例