MiniMax H3 Image API

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

1K
KIE $0.0115 / 张
官方≈$0.0312省63%–72%
2K
KIE $0.0115 / 张
官方≈$0.0328省65%–72%
4K
KIE $0.03 / 张
官方≈$0.0782省62%–69%

MiniMax H3 Image API 按张价格

KIE 按档位一口价,约为 MiniMax 刊例价的四成,每张参考图另加 $0.0025。官方价是按 Token 的估算,未计入 MiniMax 发布周 4K 五折

比较其他模型
输出规格渠道渠道公开价接口耗时试用
1K
MiniMax官方
试用
KIE
接口耗时 15秒
15秒试用
2K
MiniMax官方
接口耗时 27秒
27秒试用
KIE
接口耗时 26秒
26秒试用
4K
MiniMax官方
试用
KIE
接口耗时 37秒
37秒试用

自动路由与故障切换

用一个模型 ID 调用 MiniMax H3 Image,Yir 为每个任务在 MiniMax和KIE 中选渠道:交给当前估价最低的合格渠道,按该渠道的公开价收费、不加价。某个渠道的尝试确认失败时,在你设置的 max_cost 内换渠道重试。请求里不用写路由参数。 路由与故障转移文档

计价说明

按实际执行渠道计费;故障转移时可能切换渠道,费用和耗时随之变化。

原生 4K,权重也公开

  • 开放权重,一张 16 GB 显卡就能跑

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

  • 文字与设计类得分最高

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

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

API 接入

交给编码 Agent 写代码,在对话里用 MCP 或 Skill 直接生成,或用 SDK、OpenAI 兼容 API 自己接入。

让编码 Agent 接入

复制接入提示词,或直接在 Codex、Claude 中打开。Agent 会读取本页与模型合同,在你的项目里写好提交、等待和取结果。

添加 Yir MCP 服务器

接进 ChatGPT、Claude、Cursor 后,在对话里 @Yir 并点名 MiniMax H3 Image;它会先报价,你确认后才生成。

https://gateway.yir.ai/mcp
各客户端接入步骤

Claude Code 一行命令

先在控制台创建 API Key 并设为环境变量 YIR_API_KEY,再运行:

claude mcp add --transport http yir https://gateway.yir.ai/mcp --header "Authorization: Bearer $YIR_API_KEY"

安装 Yir Skill

在 Agent 运行环境里设好 YIR_API_KEY,装进 Claude Code、Codex 等编码 Agent 后,直接说“用 Yir 的 MiniMax H3 Image 生成……”。

npx skills add yir-ai/skills
了解 Yir Skill

通过包管理器安装官方 SDK,或直接复制下方代码进行集成

$pnpm add @yir-ai/sdk
import { createNodeYirClient } from "@yir-ai/sdk/server";
 
// 默认从环境变量读取 YIR_API_KEY: process.env.YIR_API_KEY
const client = createNodeYirClient();
 
// 1. 提交图片生成任务
const job = await client.submitImage({
model: "minimax/minimax-h3-image",
input: {
type: "text",
prompt: "为一款柑橘气泡水设计产品海报:透明玻璃瓶与鲜橙,奶油色背景,柔和自然光,清晰的产品标签",
},
parameters: {
resolution: "4K",
aspect_ratio: "1:1",
n: 1,
},
});
 
// 2. 等待任务完成并交付结果
const result = await client.waitForJob(job.id);
console.log("交付文件:", result.result);
if (result.result && "files" in result.result) {
for (const file of result.result.files) {
console.log("->", file.url);
}
}

已按 OpenAI 协议对接的项目,或 new-api 等网关,只需更换 Base URL 和 Key。 OpenAI 兼容说明

OpenAI SDK base_url
https://gateway.yir.ai/openai/v1
new-api 渠道 Base URL
https://gateway.yir.ai/openai
密钥
Yir API Key
模型 ID
minimax/minimax-h3-image
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"
  }'

参数概览

常用参数,具体限制以当前模型及所选渠道为准

API 文档
分辨率
resolution
  • 1K
  • 2K
  • 4K

成图或成片的分辨率档位,更高规格拥有更多像素细节,按档位计费

宽高比
aspect_ratio
  • 1:1
  • 2:3
  • 3:2
  • 3:4
  • 4:3
  • 4:5
  • 5:4
  • 9:16
  • 16:9
  • 21:9

画面几何比例,建议依据展示媒介(手机竖屏、横屏横幅或方形)指定

输入方式
input_mode
  • 文字生成
  • 图片输入

参考素材的数量与格式以当前模型及所选渠道支持范围为准

参考素材
references
  • reference_image ≤ 16

各输入方式下的参考素材数量上限,以所选渠道为准;价格表中的数量仅为计价示例,不代表支持上限或免费额度

常见问题

开始使用 MiniMax H3 Image

同规格跨渠道比价,一个钱包调用多个渠道。