---
title: "MiniMax H3 Image"
description: "MiniMax 开放权重生图模型，支持 4K 输出与最多 16 张参考图编辑"
seo:
  title: "MiniMax H3 Image API 文档：参数与调用示例"
  description: "MiniMax H3 Image API 文档：模型 ID minimax/minimax-h3-image、输入模式、参数取值与默认值，附请求示例。MiniMax 开放权重生图模型，支持 4K 输出与最多 16 张参考图编辑。"
---

{/* 由 scripts/generate-model-pages.mjs 根据 openapi/model-contracts.json 生成，请勿手改；补充说明写在 docs/zh/models/_notes/ */}

| 模型 ID | 别名 | 接口 |
| --- | --- | --- |
| `minimax/minimax-h3-image` | `minimax-h3-image` | [图片生成](/zh/docs/guides/image-generation) |

## 输入模式

| 模式 | 参考数量 | 参考角色 |
| --- | --- | --- |
| `text` 纯文本 | — | — |
| `image` 图片输入 | 1–16 | `reference_image` |

## 参数

| 参数 | 说明 | 取值 | 默认值 | 必填 |
| --- | --- | --- | --- | --- |
| `resolution` | 分辨率：输出内容的分辨率。 | `1K`、`2K`、`4K` | `4K` | 否 |
| `aspect_ratio` | 画幅：输出内容的宽高比。 | `1:1`、`2:3`、`3:2`、`3:4`、`4:3`、`4:5`、`5:4`、`9:16`、`16:9`、`21:9` | `1:1` | 否 |
| `size` | 精确尺寸：精确输出像素，仅选择明确支持的渠道；与分辨率档位或画幅冲突时拒绝。 | `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` | 不设置 | 否 |
| `n` | 单次请求输出数量：单次 API 请求（一个 Job）的输出数量，不是应用的批量张数。应用可提交多个独立请求组成一批；n=1 不表示应用只能生成一张。 | `1` | `1` | 否 |

## 示例

`text` 输入：

```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` 输入：

```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
  }
}
```

完整合同以 `GET /v1/models/minimax/minimax-h3-image?view=contract` 为准。参数合法不代表每个渠道都能执行，请对完整请求[报价](/zh/docs/concepts/billing#获取报价)。价格与渠道见[模型市场](https://yir.ai/zh/models)。