MiniMax H3 Max API

MiniMax H3 Max は ReachAPI の非同期タスク API を通じ、テキスト、先頭・末尾フレーム、参照画像・動画から 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`	空でないテキスト項目を 1 つ以上含めます。
`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 / 枚	1 枚ごと

成功したタスクは 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 が含まれます。