ToAPIsToAPIs
MiniMax-H3

MiniMax Hailuo H3 视频生成

使用 MiniMax Hailuo H3 生成 2K 或 768p 视频，支持文生视频、首尾帧图生视频和多模态参考生视频

POST
/v1/videos/generations

国内用户请注意： 中国大陆用户请使用 https://toapis.cn 作为接口地址（Base URL）。文档示例中的 https://toapis.com 请替换为 https://toapis.cn。

  • 支持 MiniMax-H3、MiniMax-H3-Max 和 MiniMax-H3-Max-Turbo 三个模型
  • MiniMax-H3 和 MiniMax-H3-Max 支持文生视频, 首帧/尾帧图生视频, 以及图片, 视频, 音频联合参考生成
  • MiniMax-H3-Max-Turbo 仅支持文生视频和首帧/尾帧图生视频, 不支持参考媒体
  • MiniMax-H3 保持 2K / 768p 和 4-15 秒；Max / Max-Turbo 支持 480P / 768P 和 5-15 秒
  • 异步任务接口，提交后返回统一的 generation.task

MiniMax-H3-Max-Turbo 不支持 reference_image, reference_video 或 reference_audio. 传入参考媒体会返回 MiniMax-H3-Max-Turbo does not support reference media. 如需参考视频, 请选择 MiniMax-H3 或 MiniMax-H3-Max.

请优先传入公网可访问的素材 URL。首尾帧模式与多模态参考模式互斥；参考音频不能单独使用，必须同时提供至少一张参考图或一段参考视频。

认证

Authorizationstring请求头必填

所有接口均需要使用 Bearer Token 认证。

Authorization: Bearer YOUR_API_KEY

请求参数

modelstring请求体必填默认值: MiniMax-H3

视频生成模型名称, 可选 MiniMax-H3, MiniMax-H3-Max 或 MiniMax-H3-Max-Turbo. 多模态参考仅适用于 MiniMax-H3 和 MiniMax-H3-Max; Turbo 仅支持文生视频和首帧/尾帧图生视频.

promptstring请求体必填

视频内容描述，最多 7000 个字符。建议明确描述主体、动作、场景、镜头、风格和声音要求。

durationinteger请求体默认值: 5

MiniMax-H3 支持 4-15 秒；Max / Max-Turbo 支持 5-15 秒的整数值。

resolutionstring请求体默认值: 2K

MiniMax-H3 可选 2K、768p；Max / Max-Turbo 可选 480P、768P。

aspect_ratiostring请求体默认值: 16:9

输出视频宽高比。

可选值：21:9、16:9、4:3、1:1、3:4、9:16、adaptive。

  • 文生视频：默认 16:9，不能使用 adaptive
  • 首帧/尾帧模式：始终按输入图片自适应，传入的具体比例会被忽略
  • 多模态参考模式 (仅 MiniMax-H3 和 MiniMax-H3-Max): 默认 adaptive, 也可指定具体比例
image_urlsstring[]请求体

兼容模式下的图片 URL 数组。新接入建议优先使用 image_with_roles 明确图片用途。

  • 1 张图片：作为 first_frame
  • 2 张图片：依次作为 first_frame 和 last_frame
  • 3-9 张图片: 作为 reference_image, 仅适用于 MiniMax-H3 和 MiniMax-H3-Max; Turbo 不支持

不要同时传入 image_urls 和 image_with_roles，否则图片用途可能产生歧义。

image_with_rolesarray请求体

带角色的图片数组。

显示图片字段
urlstring请求体必填

图片 URL。支持 JPG、JPEG、PNG、WebP、HEIC、HEIF；单文件不超过 30 MB，宽高均为 256-5760 px，宽高比为 0.4-2.5。

rolestring请求体必填

图片角色：

  • first_frame - 首帧，最多 1 张
  • last_frame - 尾帧，最多 1 张
  • reference_image - 参考图, 最多 9 张, 仅适用于 MiniMax-H3 和 MiniMax-H3-Max; Turbo 不支持
video_with_rolesarray请求体

多模态参考模式下的视频数组, 最多 3 段. 仅适用于 MiniMax-H3 和 MiniMax-H3-Max, Turbo 不支持.

显示视频字段
urlstring请求体必填

公网可访问的视频 URL。支持 MP4、MOV，视频编码支持 H.264/AVC、H.265/HEVC；单文件不超过 50 MB，单段时长 2-15 秒，全部参考视频总时长不超过 15 秒。

rolestring请求体必填

固定为 reference_video。

ToAPIs 会读取参考视频的实际时长用于计费，请勿提交客户端计算的时长字段。

audio_with_rolesarray请求体

多模态参考模式下的音频数组, 最多 3 段. 仅适用于 MiniMax-H3 和 MiniMax-H3-Max, Turbo 不支持.

显示音频字段
urlstring请求体必填

公网可访问的音频 URL。支持 WAV、MP3；单文件不超过 15 MB，单段时长 2-15 秒，全部参考音频总时长不超过 15 秒。

rolestring请求体必填

固定为 reference_audio。

参考音频不能单独使用，必须同时传入至少一项 reference_image 或 reference_video。

watermarkboolean请求体默认值: false

是否在生成视频中添加 AIGC 标识水印。

client_business_idstring请求体

客户侧业务 ID，例如订单号或流水号。提交后可使用同一状态接口按该 ID 查询任务。

callback_urlstring请求体

ToAPIs 标准任务完成回调地址。需先配置 Token URL 和签名密钥；详见 任务 Webhook。

disable_nsfwboolean请求体默认值: true

默认禁止生成 NSFW 内容。显式设为 false 时允许。设为 true 时，对 MiniMax-H3-Max / MiniMax-H3-Max-Turbo 会同时关闭提示词扩写（metadata.extra.prompt_expansion_mode 视为 disabled）。

输入模式

模式适用型号输入aspect_ratio
文生视频三个型号均支持prompt具体比例, 默认 16:9
首帧图生视频三个型号均支持prompt + 1 张 first_frame自动使用 adaptive
首尾帧图生视频三个型号均支持prompt + first_frame + last_frame自动使用 adaptive
多模态参考生视频仅 MiniMax-H3 和 MiniMax-H3-Maxprompt + 参考图片/视频/音频默认 adaptive, 可指定具体比例

多模态参考限制 (仅 MiniMax-H3 和 MiniMax-H3-Max):

  • 参考图最多 9 张
  • 参考视频最多 3 段
  • 参考音频最多 3 段
  • 图片、视频、音频合计最多 12 个文件
  • 首尾帧角色不能与任意参考角色混用

请求示例

参考媒体示例使用 MiniMax-H3, 不能仅将 model 替换为 MiniMax-H3-Max-Turbo. 如改用 MiniMax-H3-Max, resolution 必须使用 480P 或 768P, duration 必须为 5-15 秒.

文生视频

{
  "model": "MiniMax-H3",
  "prompt": "史诗级太空歌剧院线预告，女舰长站在巨大观景窗前，舰队跃迁离去，电影级光影",
  "duration": 5,
  "resolution": "2K",
  "aspect_ratio": "16:9"
}

首尾帧图生视频

{
  "model": "MiniMax-H3",
  "prompt": "女孩从童年自然成长为青年，镜头平稳推进，保持人物身份一致",
  "duration": 5,
  "resolution": "768p",
  "image_with_roles": [
    {"url": "https://example.com/start.jpg", "role": "first_frame"},
    {"url": "https://example.com/end.jpg", "role": "last_frame"}
  ]
}

多参考图生成

{
  "model": "MiniMax-H3",
  "prompt": "保持图片1中的人物和图片2中的服装设计，让角色走过雨夜街道",
  "duration": 6,
  "resolution": "2K",
  "aspect_ratio": "9:16",
  "image_with_roles": [
    {"url": "https://example.com/person.png", "role": "reference_image"},
    {"url": "https://example.com/outfit.png", "role": "reference_image"}
  ]
}

图片与视频联合参考

{
  "model": "MiniMax-H3",
  "prompt": "保持图片1中的人物，参考视频1的动作和运镜",
  "duration": 5,
  "resolution": "2K",
  "aspect_ratio": "adaptive",
  "image_with_roles": [
    {"url": "https://example.com/person.png", "role": "reference_image"}
  ],
  "video_with_roles": [
    {"url": "https://example.com/motion.mp4", "role": "reference_video"}
  ]
}

视频与音频联合参考

{
  "model": "MiniMax-H3",
  "prompt": "参考视频1的动作和镜头节奏，并使用音频1的音色完成角色对白",
  "duration": 5,
  "resolution": "2K",
  "aspect_ratio": "adaptive",
  "video_with_roles": [
    {"url": "https://example.com/motion.mp4", "role": "reference_video"}
  ],
  "audio_with_roles": [
    {"url": "https://example.com/voice.mp3", "role": "reference_audio"}
  ]
}

响应

idstring

ToAPIs 任务 ID，用于查询任务状态。

objectstring

对象类型，固定为 generation.task。

modelstring

本次请求使用的模型名称，固定为 MiniMax-H3。

statusstring

任务状态：queued、in_progress、completed 或 failed。

progressinteger

任务进度百分比，范围 0-100。

created_atinteger

任务创建时间的 Unix 时间戳（秒）。

提交成功后，使用 获取视频任务状态 轮询。任务完成时，视频 URL 位于 result.data[0].url。

请求示例

curl --request POST \
  --url https://toapis.com/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "MiniMax-H3",
    "prompt": "一名宇航员站在月球边缘眺望蓝色地球，镜头缓慢推进",
    "duration": 5,
    "resolution": "2K",
    "aspect_ratio": "16:9"
  }'
curl --request POST \
  --url https://toapis.com/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "MiniMax-H3",
    "prompt": "女孩从童年自然成长为青年，镜头平稳推进，保持人物身份一致",
    "duration": 5,
    "resolution": "768p",
    "image_with_roles": [
      {"url": "https://example.com/start.jpg", "role": "first_frame"},
      {"url": "https://example.com/end.jpg", "role": "last_frame"}
    ]
  }'
curl --request POST \
  --url https://toapis.com/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "MiniMax-H3",
    "prompt": "保持图片1中的人物和图片2中的服装设计，让角色走过雨夜街道",
    "duration": 6,
    "resolution": "2K",
    "aspect_ratio": "9:16",
    "image_with_roles": [
      {"url": "https://example.com/person.png", "role": "reference_image"},
      {"url": "https://example.com/outfit.png", "role": "reference_image"}
    ]
  }'
curl --request POST \
  --url https://toapis.com/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "MiniMax-H3",
    "prompt": "保持图片1中的人物，参考视频1的动作和运镜，并使用音频1的音色完成角色对白",
    "duration": 5,
    "resolution": "2K",
    "aspect_ratio": "adaptive",
    "image_with_roles": [
      {"url": "https://example.com/person.png", "role": "reference_image"}
    ],
    "video_with_roles": [
      {"url": "https://example.com/motion.mp4", "role": "reference_video"}
    ],
    "audio_with_roles": [
      {"url": "https://example.com/voice.mp3", "role": "reference_audio"}
    ]
  }'
import requests

response = requests.post(
    "https://toapis.com/v1/videos/generations",
    headers={
        "Authorization": "Bearer your-ToAPIs-key",
        "Content-Type": "application/json",
    },
    json={
        "model": "MiniMax-H3",
        "prompt": "保持图片1中的人物，参考视频1的动作和运镜，并使用音频1的音色完成角色对白",
        "duration": 5,
        "resolution": "2K",
        "aspect_ratio": "adaptive",
        "image_with_roles": [
            {"url": "https://example.com/person.png", "role": "reference_image"}
        ],
        "video_with_roles": [
            {"url": "https://example.com/motion.mp4", "role": "reference_video"}
        ],
        "audio_with_roles": [
            {"url": "https://example.com/voice.mp3", "role": "reference_audio"}
        ],
    },
)

print(response.json())
const response = await fetch("https://toapis.com/v1/videos/generations", {
  method: "POST",
  headers: {
    Authorization: "Bearer your-ToAPIs-key",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    model: "MiniMax-H3",
    prompt: "保持图片1中的人物，参考视频1的动作和运镜，并使用音频1的音色完成角色对白",
    duration: 5,
    resolution: "2K",
    aspect_ratio: "adaptive",
    image_with_roles: [
      {url: "https://example.com/person.png", role: "reference_image"}
    ],
    video_with_roles: [
      {url: "https://example.com/motion.mp4", role: "reference_video"}
    ],
    audio_with_roles: [
      {url: "https://example.com/voice.mp3", role: "reference_audio"}
    ]
  })
});

console.log(await response.json());

响应示例

{
  "id": "vid_01KZ3H3EXAMPLE00000000000",
  "object": "generation.task",
  "model": "MiniMax-H3",
  "status": "queued",
  "progress": 0,
  "created_at": 1785729000
}

MiniMax-Hailuo-2.3

使用 MiniMax Hailuo 2.3 系列模型生成视频，支持文生视频和图生视频，可选 Fast 快速模式

Vidu Q3

使用 Vidu Q3 系列模型生成视频，支持文生视频、图生视频、首尾帧、参考生成和 Subjects 生成