MiniMax H3 Max API

MiniMax H3 Max 通过 ReachAPI 异步任务接口生成 5-15 秒、480P 或 768P 视频，支持文本、首帧、首尾帧以及参考图片和视频。

MiniMax H3 是另一个模型，分辨率、时长和价格不同，参见 MiniMax H3。

Model ID: minimax-h3-max
POST /v1/vids/create
GET /v1/tasks/{task_id}

认证

Authorization: Bearer YOUR_REACH_API_KEY
Content-Type: application/json

请求参数

字段	取值 / 要求
`model`	`minimax-h3-max` (必填)
`input.content`	至少一个非空文本项。
`input.resolution`	`480P`, `768P` (必填)
`input.duration_seconds`	5 到 15 秒之间的整数。
`input.aspect_ratio`	纯文本请求必须指定固定比例：`21:9`、`16:9`、`4:3`、`1:1`、`3:4` 或 `9:16`。

纯文本请求必须指定固定比例；首帧和首尾帧模式始终采用输入图片比例，参考模式可指定生效的固定比例或使用 adaptive 跟随参考素材。

参考素材

多模态参考模式最多接受 9 张参考图片和 3 个参考视频；同一请求不能混用首尾帧与参考素材。

Type	角色	上限	取值 / 要求
`image_url`	`first_frame`	1	首帧
`image_url`	`last_frame`	1	尾帧；可以不提供首帧
`image_url`	`reference_image`	9	参考图片
`video_url`	`reference_video`	3	参考视频

素材 URL 必须能被上游公开访问。图片 URL 放在 image_url.url，视频 URL 放在 video_url.url。

提交任务

{
  "model": "minimax-h3-max",
  "input": {
    "content": [
      {
        "type": "text",
        "text": "A paper boat drifts through a rainy street at night"
      }
    ],
    "duration_seconds": 8,
    "resolution": "480P",
    "aspect_ratio": "16:9"
  }
}

参考图片请求

{
  "model": "minimax-h3-max",
  "input": {
    "content": [
      {
        "type": "text",
        "text": "Animate the subject in Image 1"
      },
      {
        "type": "image_url",
        "role": "reference_image",
        "image_url": {
          "url": "https://cdn.example.com/subject.png"
        }
      }
    ],
    "duration_seconds": 8,
    "resolution": "768P",
    "aspect_ratio": "16:9"
  }
}

价格

计费项	分辨率	价格	计费依据
输出视频	480P	$0.05 / 秒	实际输出时长
输出视频	768P	$0.08 / 秒	实际输出时长
输入视频	480P	$0.0553 / 秒	参考视频时长
输入视频	768P	$0.143 / 秒	参考视频时长
输入图片	不限	$0.074 / 张	按张计费

任务成功后根据 MiniMax 返回的实际用量结算。输入视频按请求的输出分辨率使用对应秒价。

响应与轮询

{
  "code": 200,
  "status": "queued",
  "task_id": "task_xxx",
  "data": []
}

使用返回的任务 ID 轮询 GET /v1/tasks/{task_id}，直到 status 为 success 或 failed。成功后从 data[].url 读取输出，从 cost.spend 读取实际美元费用。失败任务包含 error_code。