MiniMax H3 Image

MiniMax open-weight image model with 4K output and editing from up to 16 reference images

Model ID	Alias	Endpoint
`minimax/minimax-h3-image`	`minimax-h3-image`	Image generation

Input modes

Mode	References	Reference roles
`text` Text only	—	—
`image` Image input	1 to 16	`reference_image`

Parameters

Parameter	Description	Values	Default	Required
`resolution`	Resolution: Output resolution.	`1K`, `2K`, `4K`	`4K`	No
`aspect_ratio`	Aspect ratio: Output aspect ratio.	`1:1`, `2:3`, `3:2`, `3:4`, `4:3`, `4:5`, `5:4`, `9:16`, `16:9`, `21:9`	`1:1`	No
`size`	Exact size: Exact output pixels; only explicitly compatible supplies are eligible. Conflicting resolution/aspect ratio is rejected.	`1024x1024`, `832x1248`, `1248x832`, `896x1184`, `1184x896`, `928x1152`, `1152x928`, `768x1376`, `1376x768`, `1568x672`, `2048x2048`, `1664x2496`, `2496x1664`, `1760x2368`, `2368x1760`, `1824x2304`, `2304x1824`, `1536x2720`, `2720x1536`, `3136x1344`, `4096x4096`, `3328x4992`, `4992x3328`, `3520x4704`, `4704x3520`, `3648x4576`, `4576x3648`, `3072x5440`, `5440x3072`, `6240x2656`	Not set	No
`n`	Outputs per request: Number of outputs from one API request (one Job), not the application batch size. For multiple Jobs, submit separate requests; n=1 does not prevent application-managed batching.	`1`	`1`	No

Examples

text input:

{
  "model": "minimax/minimax-h3-image",
  "input": {
    "type": "text",
    "prompt": "A watercolor fox reading a map in a pine forest"
  },
  "parameters": {
    "resolution": "4K",
    "aspect_ratio": "1:1",
    "n": 1
  }
}

image input:

{
  "model": "minimax/minimax-h3-image",
  "input": {
    "type": "image",
    "prompt": "A watercolor fox reading a map in a pine forest",
    "references": [
      {
        "role": "reference_image",
        "file_id": "file_..."
      }
    ]
  },
  "parameters": {
    "resolution": "4K",
    "aspect_ratio": "1:1",
    "n": 1
  }
}

The authoritative contract is GET /v1/models/minimax/minimax-h3-image?view=contract. A valid parameter does not mean every channel can run it, so quote the complete request. Prices and channels are listed in Model Market.