MiniMax 请求参数与媒体输入

了解 H3 的 content 角色、分辨率、时长、媒体约束、Context-IR、视频再生成和 Max 平台参数。

H3 原生创建请求保留 content 顺序、媒体角色和显式的 false / 0。字段是否有效仍由所选上游模型校验。本页结合 H3 官方创建参数与 aiiqq.com 已接入格式说明；接口概览列出支持的五个模型。

H3 生成与 Context-IR

字段	使用方法
`model`	原生三个创建接口均为 `MiniMax-H3`，大小写须保持一致
`content`	必填数组，包含非空的 `type: "text"` 文本项及所需媒体
`resolution`	H3 生成显式传 `768P` 或 `2K`；Context-IR 不需要生成分辨率
`duration`	H3 生成及 Context-IR 的目标时长，整数 `4`–`15` 秒
`ratio`	文字输入需显式指定具体比例；媒体场景见下表
`callback_url`	可选，由上游校验并通知；H3 回调地址需按官方约定在 3 秒内原样返回验证请求的 `challenge`。轮询使用公共 ID，不使用回调中的上游 ID
`aigc_watermark`	可选布尔值；例如 `false`，不要改写为字符串

具体比例可选 21:9、16:9、4:3、1:1、3:4、9:16。

content 结构与角色

`type`	内容字段	可用角色 / 场景
`text`	`text`	提示词；每次请求包含非空文本
`image_url`	`image_url.url`	`first_frame`、`last_frame` 或 `reference_image`
`video_url`	`video_url.url`	`reference_video`；再生成另用 `base_video`
`audio_url`	`audio_url.url`	`reference_audio`

首尾帧模式与参考素材模式互斥。使用任一 reference_image、reference_video 或 reference_audio 时，不要同时加入 first_frame / last_frame。

输入场景	`ratio`
仅文字	必填具体比例，不使用 `adaptive`
首帧 / 尾帧图片	由图片决定，按 `adaptive` 处理
多模态参考	可显式指定比例，或使用 `adaptive`

首尾帧示例

{
  "model": "MiniMax-H3",
  "content": [
    {"type": "text", "text": "镜头从清晨的花苞缓慢推进，最终绽放为盛开的花朵"},
    {"type": "image_url", "image_url": {"url": "https://example.com/first.png"}, "role": "first_frame"},
    {"type": "image_url", "image_url": {"url": "https://example.com/last.png"}, "role": "last_frame"}
  ],
  "resolution": "768P",
  "duration": 4,
  "ratio": "adaptive"
}

向 POST /v2/video_generation 发送该 JSON。示例素材 URL 需替换为实际可直接下载的资源。

多模态参考示例

{
  "model": "MiniMax-H3",
  "content": [
    {"type": "text", "text": "使用参考图中的茶壶，参考视频的运镜和参考音频的节奏生成产品短片"},
    {"type": "image_url", "image_url": {"url": "https://example.com/teapot.png"}, "role": "reference_image"},
    {"type": "video_url", "video_url": {"url": "https://example.com/camera.mp4"}, "role": "reference_video"},
    {"type": "audio_url", "audio_url": {"url": "https://example.com/music.mp3"}, "role": "reference_audio"}
  ],
  "resolution": "768P",
  "duration": 4,
  "ratio": "16:9"
}

H3 媒体规格

以下为 H3 原生媒体的官方约束摘要；最终以上游校验为准。

媒体	规格
图片	JPG/JPEG/PNG/WEBP/HEIC/HEIF；单张 ≤30 MB；宽高 256–5760 px；宽高比 0.4–2.5；首帧、尾帧各最多 1 张，参考图最多 9 张
视频	MP4/MOV；H.264/H.265，音轨 AAC/MP3；单段 ≤50 MB；最多 3 段，每段 2–15 秒且合计 ≤15 秒；宽高 256–5760 px、宽高比 0.4–2.5、帧率 23.976–60
音频	WAV/MP3；单段 ≤15 MB；最多 3 段，每段 2–15 秒且合计 ≤15 秒

素材使用公网可下载的 HTTP(S) URL，避免 Base64 请求体；官方总请求体上限为 64 MB，网关还可能有接入层限制。本站不提供 MiniMax 文件上传或 mm_file:// 引用。

视频再生成

POST /v2/video_regeneration 的正文填 model: "MiniMax-H3"、resolution: "2K"。源视频须符合 H3 768P 输出规格。以下两种来源方式选择一种。

source_task_id：同一令牌最近 7 天内成功、使用 H3 原生协议的生成任务公共 ID，包含通过统一接口创建的此类 H3 任务；服务端沿用原渠道及密钥。该方式可能受供应商白名单限制。
content：包含恰好一个 role: "base_video" 视频，以及产生原视频时实际使用的最终提示词和相同参考素材。

base_video 需含音轨、24 fps，宽高可被 32 整除，帧数为 107–362。Max / Turbo 平台任务不能作为原生 source_task_id。

{
  "model": "MiniMax-H3",
  "resolution": "2K",
  "content": [
    {"type": "text", "text": "这里填写生成源视频时实际使用的最终提示词"},
    {"type": "video_url", "video_url": {"url": "https://example.com/h3-768p.mp4"}, "role": "base_video"}
  ]
}

Max 与 Max Turbo 平台格式

这两个模型发送到 POST /v1/video/generate，正文 model 分别为 minimax-h3-max 与 minimax-h3-max-turbo。Max 使用 480P / 768P、整数 5–15 秒；不使用 H3 的 2K 或 4 秒示例。

Max 可通过 extra.prompt_expansion_mode 指定 disabled、balanced 或 quality，默认 balanced。extra 位于原生平台正文顶层；使用统一视频格式时放入 metadata.extra。Turbo 的已验证最小示例为文字输入、480P、5 秒；其余选项由上游确认，不默认继承 Max 的媒体能力。

{
  "model": "minimax-h3-max",
  "content": [{"type": "text", "text": "晨光中的红色茶壶产品短片"}],
  "resolution": "480P",
  "duration": 5,
  "ratio": "16:9",
  "extra": {"prompt_expansion_mode": "balanced"}
}

平台创建响应中的 task.id 和后续查询中的 task.id 都是 aiiqq.com 公共 ID。成功时读取 task.outputs；输入/输出秒数等计量读取 task.metadata.usage。