跳到主要内容

创建 H3/H3-Max 视频

POST /v2/video_generation

使用平台 Bearer 模型密钥。请求参数直接放在 JSON 顶层；鉴权、媒体规则和计费见接入指南。

请求参数​

参数类型必选说明
modelstring是MiniMax-H3 或 MiniMax-H3-Max，区分大小写
contentarray<object>是至少一个非空文本项；可结合首尾帧或参考素材
resolutionstringH3 必填H3：768P / 2K；Max：480P / 768P，省略、null 或空字符串时默认 768P
durationinteger是H3：4–15 秒；Max：5–15 秒
ratiostring纯文本必填21:9 / 16:9 / 4:3 / 1:1 / 3:4 / 9:16 / adaptive；纯文本不能使用 adaptive
callback_urlstring否客户终态通知地址，填写前须实现回调校验；只轮询时可省略

content 中的 type、媒体 URL 对象和 role 组合限制见媒体输入规则。原生扩展字段会保留提交，上游是否接受取决于具体模型；不要将扩展字段视作平台已验证的能力。

H3 纯文本示例​

{
  "model": "MiniMax-H3",
  "resolution": "768P",
  "duration": 4,
  "ratio": "16:9",
  "content": [
    {"type": "text", "text": "一只小猫在阳光下伸懒腰，镜头缓慢推进"}
  ]
}

H3-Max 首帧示例​

将示例图片地址替换为上游可访问的真实素材地址。本例省略 resolution，平台按 768P 提交。

{
  "model": "MiniMax-H3-Max",
  "duration": 5,
  "ratio": "16:9",
  "content": [
    {"type": "text", "text": "保持人物外观，人物缓慢转身看向镜头"},
    {"type": "image_url", "role": "first_frame", "image_url": {"url": "https://example.com/first-frame.png"}}
  ]
}

H3 多模态参考示例​

参考模式不能混用 first_frame / last_frame。请替换所有示例素材地址。

{
  "model": "MiniMax-H3",
  "resolution": "2K",
  "duration": 6,
  "ratio": "16:9",
  "content": [
    {"type": "text", "text": "参考图片中的主体、视频的运动节奏和音频氛围生成短片"},
    {"type": "image_url", "role": "reference_image", "image_url": {"url": "https://example.com/reference.png"}},
    {"type": "video_url", "role": "reference_video", "video_url": {"url": "https://example.com/reference.mp4"}},
    {"type": "audio_url", "role": "reference_audio", "audio_url": {"url": "https://example.com/reference.mp3"}}
  ]
}

响应（HTTP 200）​

{"task_id":"task_platform_example"}

task_id 为平台任务 ID。保存后通过查询任务等待 succeeded，从 task.content.url 获取视频。不要用它直接请求上游 MiniMax。错误格式见查询与错误处理。