---
title: "MiniMax H3 Image"
description: "MiniMax open-weight image model with 4K output and editing from up to 16 reference images"
seo:
  title: "MiniMax H3 Image API Documentation: Parameters & Examples"
  description: "MiniMax H3 Image API documentation: model ID minimax/minimax-h3-image, input modes, parameters, defaults and request examples. MiniMax open-weight image model with 4K output and editing from up to 16 reference images."
---

{/* Generated by scripts/generate-model-pages.mjs from openapi/model-contracts.json. Do not edit; write notes in docs/models/_notes/ */}

| Model ID | Alias | Endpoint |
| --- | --- | --- |
| `minimax/minimax-h3-image` | `minimax-h3-image` | [Image generation](/docs/guides/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:

```json
{
  "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:

```json
{
  "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](/docs/concepts/billing#get-a-quote) the complete request. Prices and channels are listed in [Model Market](https://yir.ai/models).