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。