MiniMax H3 Max API

MiniMax H3 Max generates 5-15 second videos at 480P or 768P from text, first/last frames, or reference images and videos through ReachAPI's asynchronous task API.

MiniMax H3 is a separate model with different resolutions, durations, and prices. See MiniMax H3.

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

Authentication

Authorization: Bearer YOUR_REACH_API_KEY
Content-Type: application/json

Request parameters

Field	Value / requirement
`model`	`minimax-h3-max` (Required)
`input.content`	At least one non-empty text item.
`input.resolution`	`480P`, `768P` (Required)
`input.duration_seconds`	Integer from 5 to 15 seconds.
`input.aspect_ratio`	Text-only requests require a fixed ratio: `21:9`, `16:9`, `4:3`, `1:1`, `3:4`, or `9:16`.

Text-only requests require a fixed aspect ratio. Frame modes always use the input image ratio, while reference mode supports an effective fixed ratio or adaptive source ratio.

Reference media

Multimodal reference mode accepts up to 9 reference images and 3 reference videos. Frame inputs and reference media cannot be mixed in one request.

Type	Role	Limit	Value / requirement
`image_url`	`first_frame`	1	First frame
`image_url`	`last_frame`	1	Last frame; can be supplied without a first frame
`image_url`	`reference_image`	9	Reference images
`video_url`	`reference_video`	3	Reference videos

Use publicly fetchable media URLs. Put image URLs in image_url.url and video URLs in video_url.url.

Create a task

{
  "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"
  }
}

Reference image request

{
  "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"
  }
}

Pricing

Meter	Resolution	Price	Billing basis
Output video	480P	$0.05 / second	Actual output duration
Output video	768P	$0.08 / second	Actual output duration
Input video	480P	$0.0553 / second	Reference video duration
Input video	768P	$0.143 / second	Reference video duration
Input image	Any	$0.074 / image	Per image

Successful tasks are settled from the usage returned by MiniMax. Input video is billed at the rate for the requested output resolution.

Responses and polling

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

Poll GET /v1/tasks/{task_id} using the returned task ID until status is success or failed. On success, read the output from data[].url and the actual USD charge from cost.spend. A failed task includes error_code.