- 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 五折
自动路由与故障切换
用一个模型 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
生成示例
以下画面都由 MiniMax H3 Image 生成,点开任一张,带着原提示词去调试台试
裁到 100%,细节依然经得起看
每格都是上方 4K 原图的 1:1 像素裁切,只占整张图约 7%

手写香料标签

补网的粗糙双手

蛛网上的露珠

梯子上取书的人
API 接入
交给编码 Agent 写代码,在对话里用 MCP 或 Skill 直接生成,或用 SDK、OpenAI 兼容 API 自己接入。
让编码 Agent 接入
复制接入提示词,或直接在 Codex、Claude 中打开。Agent 会读取本页与模型合同,在你的项目里写好提交、等待和取结果。
添加 Yir MCP 服务器
接进 ChatGPT、Claude、Cursor 后,在对话里 @Yir 并点名 MiniMax H3 Image;它会先报价,你确认后才生成。
https://gateway.yir.ai/mcpClaude 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通过包管理器安装官方 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"
}'参数概览
常用参数,具体限制以当前模型及所选渠道为准
- 分辨率 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
各输入方式下的参考素材数量上限,以所选渠道为准;价格表中的数量仅为计价示例,不代表支持上限或免费额度





