MiniMax H3

MiniMax-H3 是面向视频生成的多模态模型。它支持文本、首尾帧、参考图片、参考视频和参考音频输入，生成任务采用异步模式：先创建任务，再根据 task_id 查询结果。

核心能力

文本生成视频 — 通过提示词控制主体、场景、镜头和动作
首尾帧控制 — 传入首帧，或同时传入首帧与尾帧
多模态参考 — 最多组合 12 个图片、视频和音频素材
灵活输出 — 支持 768P、2K，时长范围为 4–15 秒
异步任务 — 支持轮询查询，也可设置 callback_url 接收任务状态通知

快速开始

1. 创建视频任务

curl --request POST \
  --url https://www.anyfast.com.cn/minimax/v2/video_generation \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "MiniMax-H3",
    "content": [
      {
        "type": "text",
        "text": "电影感航拍镜头，清晨的云海缓慢掠过雪山，光线柔和"
      }
    ],
    "resolution": "768P",
    "duration": 6,
    "ratio": "16:9",
    "aigc_watermark": false
  }'

import requests

response = requests.post(
    "https://www.anyfast.com.cn/minimax/v2/video_generation",
    headers={
        "Authorization": "Bearer YOUR_API_KEY",
        "Content-Type": "application/json",
    },
    json={
        "model": "MiniMax-H3",
        "content": [
            {
                "type": "text",
                "text": "电影感航拍镜头，清晨的云海缓慢掠过雪山，光线柔和",
            }
        ],
        "resolution": "768P",
        "duration": 6,
        "ratio": "16:9",
        "aigc_watermark": False,
    },
)

response.raise_for_status()
task_id = response.json()["task_id"]
print(task_id)

创建成功后返回：

{
  "task_id": "1234567890"
}

2. 查询任务结果

curl --request GET \
  --url https://www.anyfast.com.cn/minimax/v2/query/video_generation/1234567890 \
  --header 'Authorization: Bearer YOUR_API_KEY'

import requests

task_id = "1234567890"
response = requests.get(
    f"https://www.anyfast.com.cn/minimax/v2/query/video_generation/{task_id}",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
)

response.raise_for_status()
task = response.json()["task"]
print(task["status"], task.get("content", {}).get("url"))

任务状态包括 queued、running、succeeded、failed 和 cancelled。成功后可从 task.content.url 获取视频地址。查询接口仅保证可查询最近 7 天内创建的任务。

输入模式

content 必须且只能包含一个非空的 text 项，还可以添加媒体项：

输入类型	`type`	可用 `role`	数量限制
提示词	`text`	不使用	必须且仅 1 个
图片	`image_url`	`first_frame`、`last_frame`、`reference_image`	首帧 1、尾帧 1、参考图最多 9
视频	`video_url`	`reference_video`	最多 3 个，总时长不超过 15 秒
音频	`audio_url`	`reference_audio`	最多 3 个，总时长不超过 15 秒

首帧/尾帧模式不能与参考图片、参考视频或参考音频模式混用。所有媒体项合计最多 12 个。

首帧图生视频示例

{
  "model": "MiniMax-H3",
  "content": [
    {
      "type": "text",
      "text": "人物缓慢转身看向镜头，发丝随风飘动"
    },
    {
      "type": "image_url",
      "image_url": {
        "url": "https://example.com/first-frame.jpg"
      },
      "role": "first_frame"
    }
  ],
  "resolution": "768P",
  "duration": 6,
  "ratio": "adaptive"
}

多模态参考示例

{
  "model": "MiniMax-H3",
  "content": [
    {
      "type": "text",
      "text": "参考人物形象、运镜节奏和背景音乐，生成一段产品展示视频"
    },
    {
      "type": "image_url",
      "image_url": { "url": "https://example.com/character.png" },
      "role": "reference_image"
    },
    {
      "type": "video_url",
      "video_url": { "url": "https://example.com/camera-motion.mp4" },
      "role": "reference_video"
    },
    {
      "type": "audio_url",
      "audio_url": { "url": "https://example.com/music.mp3" },
      "role": "reference_audio"
    }
  ],
  "resolution": "2K",
  "duration": 10,
  "ratio": "adaptive"
}

参数说明

参数	类型	必填	说明
`model`	string	是	固定为 `MiniMax-H3`
`content`	array	是	提示词与媒体输入，合计最多 12 项
`resolution`	string	否	`768P` 或 `2K`
`duration`	integer	否	4–15 秒
`ratio`	string	否	`adaptive`、`21:9`、`16:9`、`4:3`、`1:1`、`3:4`、`9:16`
`callback_url`	string	否	接收任务状态通知的 HTTPS 地址
`aigc_watermark`	boolean	否	是否添加 AIGC 水印，默认 `false`

纯文本生成视频时，ratio 不能使用 adaptive，请指定一个明确比例。图生视频或参考素材模式可使用 adaptive。

媒体要求

请求体总大小不超过 64 MB
图片支持 JPG、JPEG、PNG、WEBP、HEIC、HEIF，单张不超过 30 MB
视频支持 MP4、MOV；视频编码支持 H.264/H.265，音频编码支持 AAC/MP3；单个不超过 50 MB、时长 2–15 秒
音频支持 WAV、MP3；单个不超过 15 MB、时长 2–15 秒
图片和视频宽高均为 256–5760 像素，宽高比范围为 0.4–2.5
视频帧率范围为 23.976–60 FPS

创建视频任务

查看完整请求字段并在线调试。

查询视频任务

根据 task_id 查询状态与视频结果。

快速开始

模型 API

资源

核心能力

快速开始

1. 创建视频任务

2. 查询任务结果

输入模式

首帧图生视频示例

多模态参考示例

参数说明

媒体要求

创建视频任务

查询视频任务

​核心能力

​快速开始

​1. 创建视频任务

​2. 查询任务结果

​输入模式

​首帧图生视频示例

​多模态参考示例

​参数说明

​媒体要求

创建视频任务

查询视频任务

核心能力

快速开始

1. 创建视频任务

2. 查询任务结果

输入模式

首帧图生视频示例

多模态参考示例

参数说明

媒体要求