> ## Documentation Index
> Fetch the complete documentation index at: https://docs.geekai.co/llms.txt
> Use this file to discover all available pages before exploring further.

# MiniMax-H3-Image

这是一款衍生自 H3 视频模型的图像生成模型，其具备文本生成图像、图像参考和图像编辑能力。它能够在 10 秒内生成一张 4096 x 4096 像素、约 16 MP（4K）的高分辨率图像，同时呈现丰富、真实的细节，并具备优秀的指令遵循和多参考图理解能力。

### 模型参数

* 模型ID：`MiniMax-H3-Image`/`MiniMax-H3-Image-Highspeed`(极速版)
* 模型价格：你可以在模型详情页查看最新价格信息👉[MiniMax-H3-Image](https://geekai.co/models/MiniMax-H3-Image)、[MiniMax-H3-Image-Highspeed](https://geekai.co/models/MiniMax-H3-Image-Highspeed)
* 调用入口：`https://geekai.co/api/v1/images/generations`
* 模型参数：参考[画图 API 手册](https://docs.geekai.co/cn/api/image/generations.md)
* API认证：[获取 API KEY](https://geekai.co/user/api_keys)

> [!NOTE]
>
> 不支持画图 API 中的以下参数：
>
> * `negative_prompt`
> * `strength`
> * `aspect_ratio`
> * `quality`
> * `style_preset`
> * `mask`
>
> 附：[MiniMax-H3-Image 官方 API 文档](https://platform.minimax.cn/docs/guides/image-generation)

图生图场景支持通过 `image` 字段传入参考图，支持 URL 或 Base64 编码的图片数据，最大支持 16 张，多张图片通过数组传递即可。图像要求如下：

* 支持的图片格式：JPG、JPEG、PNG、WEBP、HEIC、HEIF；
* 图片大小限制：单张图片不超过 64MB，长边与短边之比不超过4:1，短边必须大于18px，长边不得超过 8192px。

MiniMax-H3-Image 支持通过 `size` 字段或 `size` + `aspect_ratio` 字段设置生图尺寸，该字段支持两种方式传值：

* 指定生成图像的分辨率: `1K`、`2K`、`4K`（普通生图场景默认值），此时可以通过 `aspect_ratio` 字段指定宽高比。
* 指定生成图像的宽高像素值，宽高比在1:3\~3:1之间，总像素在\[655360, 20000000]之间，此时不支持 `aspect_ratio` 字段。

如果 `size` 和 `aspect_ratio` 均为空，则默认生成 `4K` 分辨率的图片，宽高比为 `auto`，即模型会根据提示词自动判断宽高比。

MiniMax-H3-Image 支持通过 `output_format` 控制图片输出格式为 `png`、`jpeg`、`webp`，默认值为 `jpeg`。

MiniMax-H3-Image 支持通过 `response_format` 控制图片响应格式为 `url`、`b64_json`，默认值为 `url`。

极客智坊支持通过 `enhance_prompt` 字段替代官方的 `disable_prompt_enhanced` 设置提示词优化功能使用的模式，默认值为 `true`，即默认启用提示词优化。

### 模型价格

MiniMax-H3-Image 模型的价格按照生成图片的分辨率来计算：

| 模型ID | 场景 | 输入图片 | 图片尺寸 | 价格（元/张） |
| - | - | - | - | - |
| `MiniMax-H3-Image` | 文生图 | - | 1K | 0.143 |
| `MiniMax-H3-Image` | 文生图 | - | 2K | 0.153 |
| `MiniMax-H3-Image` | 文生图 | - | 4K | 0.452 |
| `MiniMax-H3-Image` | 图生图（1张参考图） | 1K | 1K | 0.174 |
| `MiniMax-H3-Image` | 图生图（1张参考图） | 1K | 2K | 0.175 |
| `MiniMax-H3-Image` | 图生图（1张参考图） | 1K | 4K | 0.481 |
| `MiniMax-H3-Image` | 图生图（3张参考图） | 1K | 1K | 0.235 |
| `MiniMax-H3-Image` | 图生图（3张参考图） | 1K | 2K | 0.275 |
| `MiniMax-H3-Image` | 图生图（3张参考图） | 1K | 4K | 0.521 |
| `MiniMax-H3-Image-Highspeed` | 文生图 | - | 1K | 0.232 |
| `MiniMax-H3-Image-Highspeed` | 文生图 | - | 2K | 0.238 |
| `MiniMax-H3-Image-Highspeed` | 文生图 | - | 4K | 0.855 |
| `MiniMax-H3-Image-Highspeed` | 图生图（1张参考图） | 1K | 1K | 0.298 |
| `MiniMax-H3-Image-Highspeed` | 图生图（1张参考图） | 1K | 2K | 0.301 |
| `MiniMax-H3-Image-Highspeed` | 图生图（1张参考图） | 1K | 4K | 0.9 |
| `MiniMax-H3-Image-Highspeed` | 图生图（3张参考图） | 1K | 1K | 0.398 |
| `MiniMax-H3-Image-Highspeed` | 图生图（3张参考图） | 1K | 2K | 0.4 |
| `MiniMax-H3-Image-Highspeed` | 图生图（3张参考图） | 1K | 4K | 1.015 |

使用极客智坊提供的[低价代理渠道](https://docs.geekai.co/cn/docs/model_price.md)调用时，不同参数对应价格按照价格表x对应的折扣值即可。以高可用Pro通道文生图为例，折扣值是 `0.8`，那么生成一张 `size` 为 `1K` 的图片价格是 `0.143 x 0.8 = 0.114` 元。其他参数依次类推。

### 文生图

通过给模型提供清晰准确的文字指令，即可快速获得符合描述的高质量单张图片：

```bash theme={null}
curl --location --request POST 'https://geekai.co/api/v1/images/generations' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer $GEEKAI_API_KEY' \
--data '{
    "model": "MiniMax-H3-Image",
    "prompt": "充满活力的特写编辑肖像，模特眼神犀利，头戴雕塑感帽子，色彩拼接丰富，眼部焦点锐利，景深较浅，具有Vogue杂志封面的美学风格，采用中画幅拍摄，工作室灯光效果强烈。",
    "output_format":"png"
}'
```

响应是一个 JSON 对象，包含生成图片的 URL：

```json theme={null}
{
    "model": "MiniMax-H3-Image",
    "created": 1787563947,
    "task_id": "eae17a81-d0b9-49a5-9c31-749d56f48a66",
    "task_status": "succeed",
    "data": [
        {
            "url": "https://static.geekai.co/image/2026/08/24/3875c0d7366011f7de9f32ec2f010f29.png",
            "size": "1776x2368"
        }
    ],
    "usage": {
        "billed_units": 1,
        "output_tokens": 16428,
        "total_tokens": 16428
    }
}
```

下面的图生图的输出结果同上述结果，不在列举。

### 图生图

Doubao-Seedream-5.0-Pro 支持图生图功能，可以在原有图片的基础上进行修改，生成新的图片。你可以通过 `image` 字段传入一张或多张图片，并在 `prompt` 中描述你希望对这些图片进行的修改。

**单图**

```bash theme={null}
curl --location --request POST 'https://geekai.co/api/v1/images/generations' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer $GEEKAI_API_KEY' \
--data '{
    "model": "MiniMax-H3-Image",
    "prompt": "生成狗狗趴在草地上的近景画面",
    "image": "https://ark-project.tos-cn-beijing.volces.com/doc_image/seedream4_imageToimage.png",
    "output_format":"jpeg"
}'
```

**多图**

```bash theme={null}
curl --location --request POST 'https://geekai.co/api/v1/images/generations' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer $GEEKAI_API_KEY' \
--data '{
    "model": "MiniMax-H3-Image",
    "prompt": "将图1的服装换为图2的服装",
    "image": [
        "https://ark-project.tos-cn-beijing.volces.com/doc_image/seedream4_imagesToimage_1.png", 
        "https://ark-project.tos-cn-beijing.volces.com/doc_image/seedream4_5_imagesToimage_2.png"
    ],
    "output_format":"png",
    "watermark": false
}'
```

MiniMax-H3-Image 最多支持传入 16 张参考图片。

> [!NOTE]
>
> MiniMax-H3-Image-Highspeed 调用 API 生图和 MiniMax-H3-Image 完全一致，只需要替换模型ID即可。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.