# MiniMax H3 Image

> MiniMax 的开放权重生图模型：原生 4K 最高约 1700 万像素，支持最多 16 张参考图编辑

- 模型页: https://yir.ai/zh/models/minimax-h3-image
- 模型 ID: `minimax/minimax-h3-image`
- 计费：按实际执行渠道的上游计费收取；上游未计费的尝试不收费。

## 原生 4K，权重也公开

### 开放权重，一张 16 GB 显卡就能跑

权重已在 Hugging Face 公开；有人用单张 16 GB 的 RTX 5080 跑出 1600 万像素的图，其余部分从内存流式加载

### 文字与设计类得分最高

第三方以 1600 万像素跑了 600 条提示词，AI 评审平均 3.94 分（满分 5）

- 文字与设计: 4.36
- 人物: 4.22
- 商业: 3.56
- 信息设计: 3.56

## 价格

同一输出规格下各渠道的当前公开价；官方价为参考。实际按执行渠道计费，故障转移时可能切换渠道。

| 输出规格 | 渠道 | 公开价 |
|---|---|---|
| 1K | MiniMax (官方) (文本输入) | ≈$0.0218 / 张 |
| 1K | MiniMax (官方) (图片输入) | ≈$0.0312 / 张 |
| 1K | MiniMax (官方) (图片输入) | ≈$0.0406 / 张 |
| 1K | MiniMax (官方) (图片输入) | ≈$0.0501 / 张 |
| 1K | MiniMax (官方) (图片输入) | ≈$0.0595 / 张 |
| 1K | MiniMax (官方) (图片输入) | ≈$0.0689 / 张 |
| 1K | MiniMax (官方) (图片输入) | ≈$0.0783 / 张 |
| 1K | MiniMax (官方) (图片输入) | ≈$0.0877 / 张 |
| 1K | MiniMax (官方) (图片输入) | ≈$0.0972 / 张 |
| 1K | MiniMax (官方) (图片输入) | ≈$0.1066 / 张 |
| 1K | MiniMax (官方) (图片输入) | ≈$0.116 / 张 |
| 1K | MiniMax (官方) (图片输入) | ≈$0.1254 / 张 |
| 1K | MiniMax (官方) (图片输入) | ≈$0.1348 / 张 |
| 1K | MiniMax (官方) (图片输入) | ≈$0.1443 / 张 |
| 1K | MiniMax (官方) (图片输入) | ≈$0.1537 / 张 |
| 1K | MiniMax (官方) (图片输入) | ≈$0.1631 / 张 |
| 1K | MiniMax (官方) (图片输入) | ≈$0.1725 / 张 |
| 1K | KIE | $0.009 ~ $0.0115 / 张 |
| 2K | MiniMax (官方) (文本输入) | ≈$0.0233 / 张 |
| 2K | MiniMax (官方) (图片输入) | ≈$0.0328 / 张 |
| 2K | MiniMax (官方) (图片输入) | ≈$0.0422 / 张 |
| 2K | MiniMax (官方) (图片输入) | ≈$0.0516 / 张 |
| 2K | MiniMax (官方) (图片输入) | ≈$0.061 / 张 |
| 2K | MiniMax (官方) (图片输入) | ≈$0.0704 / 张 |
| 2K | MiniMax (官方) (图片输入) | ≈$0.0799 / 张 |
| 2K | MiniMax (官方) (图片输入) | ≈$0.0893 / 张 |
| 2K | MiniMax (官方) (图片输入) | ≈$0.0987 / 张 |
| 2K | MiniMax (官方) (图片输入) | ≈$0.1081 / 张 |
| 2K | MiniMax (官方) (图片输入) | ≈$0.1175 / 张 |
| 2K | MiniMax (官方) (图片输入) | ≈$0.127 / 张 |
| 2K | MiniMax (官方) (图片输入) | ≈$0.1364 / 张 |
| 2K | MiniMax (官方) (图片输入) | ≈$0.1458 / 张 |
| 2K | MiniMax (官方) (图片输入) | ≈$0.1552 / 张 |
| 2K | MiniMax (官方) (图片输入) | ≈$0.1646 / 张 |
| 2K | MiniMax (官方) (图片输入) | ≈$0.1741 / 张 |
| 2K | KIE | $0.009 ~ $0.0115 / 张 |
| 4K | MiniMax (官方) (文本输入) | ≈$0.0688 / 张 |
| 4K | MiniMax (官方) (图片输入) | ≈$0.0782 / 张 |
| 4K | MiniMax (官方) (图片输入) | ≈$0.0876 / 张 |
| 4K | MiniMax (官方) (图片输入) | ≈$0.0971 / 张 |
| 4K | MiniMax (官方) (图片输入) | ≈$0.1065 / 张 |
| 4K | MiniMax (官方) (图片输入) | ≈$0.1159 / 张 |
| 4K | MiniMax (官方) (图片输入) | ≈$0.1253 / 张 |
| 4K | MiniMax (官方) (图片输入) | ≈$0.1347 / 张 |
| 4K | MiniMax (官方) (图片输入) | ≈$0.1442 / 张 |
| 4K | MiniMax (官方) (图片输入) | ≈$0.1536 / 张 |
| 4K | MiniMax (官方) (图片输入) | ≈$0.163 / 张 |
| 4K | MiniMax (官方) (图片输入) | ≈$0.1724 / 张 |
| 4K | MiniMax (官方) (图片输入) | ≈$0.1818 / 张 |
| 4K | MiniMax (官方) (图片输入) | ≈$0.1913 / 张 |
| 4K | MiniMax (官方) (图片输入) | ≈$0.2007 / 张 |
| 4K | MiniMax (官方) (图片输入) | ≈$0.2101 / 张 |
| 4K | MiniMax (官方) (图片输入) | ≈$0.2195 / 张 |
| 4K | KIE | $0.0275 ~ $0.03 / 张 |

## 参数

- 操作: `generate_image`

| 参数 | 可选值 | 默认值 |
|---|---|---|
| `input` | text / image | text |
| `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 |

## 接入

两种方式任选：新项目用官方 SDK；已按 OpenAI 协议对接的项目换 Base URL 即可。

### 官方 SDK（TypeScript）

SDK 调用 Standard API（https://gateway.yir.ai），支持提交、等待和获取结果，另有 Go SDK。 https://yir.ai/zh/docs/integrations/sdk

```bash
pnpm add @yir-ai/sdk
```

```ts
import { createNodeYirClient } from "@yir-ai/sdk/server";

// Reads YIR_API_KEY from the environment by default: process.env.YIR_API_KEY
const client = createNodeYirClient();

// 1. Submit an image generation job
const job = await client.submitImage({
  model: "minimax/minimax-h3-image",
  input: {
    type: "text",
    prompt: "为一款柑橘气泡水设计产品海报：透明玻璃瓶与鲜橙，奶油色背景，柔和自然光，清晰的产品标签",
  },
  parameters: {
    resolution: "4K",
    aspect_ratio: "1:1",
    n: 1,
  },
});

// 2. Wait for the job to finish and deliver its result
const result = await client.waitForJob(job.id);
console.log("Delivered files:", result.result);
if (result.result && "files" in result.result) {
  for (const file of result.result.files) {
    console.log("->", file.url);
  }
}
```

### OpenAI 兼容 API

OpenAI Images 与 Sora Videos 协议，适用于 OpenAI SDK 和 new-api 等网关；不支持对话。 https://yir.ai/zh/docs/integrations/openai-compatibility

- OpenAI SDK base_url: `https://gateway.yir.ai/openai/v1`
- new-api 渠道 Base URL（渠道类型 OpenAI）: `https://gateway.yir.ai/openai`
- 模型 ID: `minimax/minimax-h3-image`

```bash
curl https://gateway.yir.ai/openai/v1/images/generations \
  -H "Authorization: Bearer $YIR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "minimax/minimax-h3-image",
    "prompt": "为一款柑橘气泡水设计产品海报：透明玻璃瓶与鲜橙，奶油色背景，柔和自然光，清晰的产品标签",
    "resolution": "4K",
    "aspect_ratio": "1:1"
  }'
```

## 常见问题

### MiniMax H3 Image 有官方 API 吗？

有。MiniMax 通过自己的官方 API 提供 MiniMax H3 Image，上表把它的刊例价列为官方参考价。通过 Yir 用一个 API Key 即可调用 MiniMax H3 Image，并与各渠道的公开价对比。

### MiniMax H3 Image 和 Nano Banana 2.1 选哪个？

以后想自己部署或微调开放权重，用 MiniMax H3 Image。价格优先就用 Nano Banana 2.1：它在 Yir 上最便宜的 4K 渠道比 H3 Image 低，可故障切换的渠道也更多。

### MiniMax H3 Image 的 4K 是多大像素？

约 1600 万到 1700 万像素。KIE 渠道 4K 在 1:1 为 4096 × 4096，16:9 为 5472 × 3072，21:9 为 6272 × 2688；官方渠道 16:9 最大为 5440 × 3072。

### MiniMax H3 Image 出 4K 要多久？

MiniMax 称在自家平台 4K 单张不到 10 秒。我们在 KIE 渠道实测 6 张 4K 文生图，处理耗时 23 到 39 秒，中位数约 28 秒（2026 年 11 月）。

### MiniMax H3 Image 能在图里写字吗？

能。本页徒步地图里的标题、地名和图例都和提示词一字不差，不过模型多加了一行我们没要求的“EST. 1925”。把要出现的文字放进引号，并写明位置。

### MiniMax H3 Image 开源吗？

权重已在 Hugging Face 公开（MiniMaxAI/MiniMax-H3-Image），以后可以自行部署或微调。通过 Yir 调用的是 MiniMax 官方 API 或 KIE，不需要自己部署。

## 接入须知

- 使用 Authorization: Bearer $YIR_API_KEY 鉴权；Key 只放服务端环境变量，不进浏览器代码、仓库、提示词或日志。
- 任务是异步的：提交后保存 Job ID，等待终态再读取结果；处理失败与取消。
- 安全重试时复用同一个幂等键和请求，不要在结果未知时盲目重新提交。
- 结果链接是临时的，需要长期保存请自行转存。

## 链接

- [快速开始](https://yir.ai/zh/docs/getting-started/quickstart)
- [API 参考](https://yir.ai/zh/docs/reference)
- [llms.txt](https://yir.ai/llms.txt)