MiniMax H3 Image API —— 文生图与最多 16 张参考图改图,1K 到 4K
minimax-h3-imageMiniMax H3 Image 是 MiniMax 的图像生成模型,在 apimodels.app 上一个 API Key 即可调用,模型名 minimax-h3-image(MiniMax 自己的写法 MiniMax-H3-Image 也认)。一个模型同时做文生图和改图:只传提示词就是文生图;再加 1 到 16 张参考图,提示词里按「图1、图2……」指代,就能改照片的局部、换风格,或把几张图合成一张。每次请求出 1 到 10 张。 尺寸有两种定法:按面积档位 1K / 2K / 4K(缺省 2K)加 auto 或 1:3 到 3:1 之间任意比例;或者直接给精确尺寸,面积在 655,360 到 20,000,000 像素之间。缺省输出 JPEG,也可以要 PNG 或 WebP。文生图默认经过模型的提示词增强,不想要可以用 disable_prompt_enhanced 关掉;改图始终增强。我们实测:1K 16:9 文生图约 10 秒,实得 1360×768;带一张参考图的 1K 改图约 16 秒。 价格:1K、2K 每张 $0.03,4K 每张 $0.10(自定义尺寸超过约 500 万像素按 4K 算),每张参考图另加 $0.01;只对实际出成的图收费,整单失败不扣费。超过约 240 万像素的参考图会先等比缩小再发出。不保证每次都成功:提示词或图片可能被内容审核拒掉。不支持遮罩、透明背景、反向提示词和 seed,传了会直接返回 400,不会被悄悄忽略。要更快出图,用 minimax-h3-image-highspeed。
Generate Image
Result
Generated image will appear here
Enter a prompt and click Generate
一个模型,文生图和改图都能做
只给提示词就是文生图;再加 1–16 张参考图(提示词里按「图1、图2」指代),可以改照片局部、换风格或把几张图合成一张
1K、2K 或 4K,比例 1:3 到 3:1
按面积档位出图(缺省 2K),比例选 auto 或任意 X:Y;也可以直接给 655,360 到 20,000,000 像素之间的精确尺寸。输出 JPEG、PNG 或 WebP
一次 1–10 张
n 最多 10,一个响应里全部返回;只对实际出成的图收费
每张 $0.03 / $0.10
1K 或 2K $0.03,4K $0.10(自定义尺寸超过约 5 MP 按 4K 算),每张参考图另加 $0.01
限制
不支持遮罩、透明背景、反向提示词和 seed,传了直接返回 400,不会被悄悄忽略。参考图最多 16 张,每张宽高 128–8192 px、长边不超过短边 4:1;超过约 2.4 MP 的参考图会先缩小再发出
不是 100% 成功,但失败不收钱
不保证每次都成功,内容审核可能拒掉提示词或图片。失败的请求会返回原因,不扣费
MiniMax H3 Image API:文生图与最多 16 张参考图改图,1K 到 4K
MiniMax H3 Image 是 MiniMax 的图像生成模型。传一段提示词,一次返回 1 到 10 张图;再加最多 16 张参考图,就能改照片的局部、换风格,或把几张图合成一张。尺寸从 1K 到 4K,形状在 1:3 到 3:1 之间任选。
在 APIMODELS 上它是一个模型名 minimax-h3-image,走 POST /v1/images/generations:1K 或 2K 每张 $0.03,4K 每张 $0.10,每张参考图另加 $0.01。它不支持遮罩、透明背景和 seed,也不保证每次都成功,具体限制见下表。
- 模型名
minimax-h3-image- 输入
- 文字提示词,可加最多 16 张参考图
- 输出
- 1–10 张,1K / 2K / 4K(缺省 2K)
- 画幅
- auto 或 1:3 到 3:1 任意比例
- 价格
- $0.03(1K / 2K)、$0.10(4K),每张参考图 +$0.01
MiniMax H3 Image API 的限制条件一览
模型收什么、不收什么。不支持的输入在出图前就返回 400,不会被悄悄忽略,你不会为一张没按要求出的图付钱。
| 支持 | 不支持 | |
|---|---|---|
| 输入 | 一段最多 32,000 字符的文字提示词,可再加 1–16 张参考图做改图、换风格或多图合成(提示词里按「图1、图2」指代) | 遮罩(局部重绘) |
| 参考图 | 1–16 张(每张另加 $0.01),公网网址或 base64 data URI;每张宽高 128–8192 像素、长边不超过短边的 4 倍、不超过 64 MB。超过约 240 万像素的先等比缩小再发出 | 超过 16 张;尺寸超出上述范围(400) |
| 每次张数 | 1–10 张(n);只对实际出成的图收费 | n 大于 10(400) |
| 尺寸 | resolution 1K / 2K / 4K(缺省 2K)加 aspect_ratio auto 或 1:3 到 3:1 之间任意 X:Y;或精确尺寸 size 宽x高,面积 655,360 到 20,000,000 像素 | 比 1:3 或 3:1 更极端的形状;面积超出范围的精确尺寸(400) |
| 输出格式 | 缺省 JPEG;output_format 可选 PNG 或 WebP | 透明背景(background: transparent 返回 400) |
| 提示词增强 | 缺省开启。文生图可用 disable_prompt_enhanced: true 关闭,同时要给 aspect_ratio 或 size | 改图时关闭(改图始终增强) |
| 其他 | aigc_watermark(true / false) | negative_prompt 和 seed(400;结果不可复现) |
MiniMax H3 Image 不保证每次都成功
和所有图片模型一样,它的成功率不是 100%。只对出成的图收费。
请求被接受后仍然可能失败:提示词或参考图可能被内容审核拒掉,生成也可能遇到临时错误。失败的请求会返回原因,不扣费。一次要多张、只出成一部分时,只收出成的那几张。
我们 2026 年 11 月 11 日测试的 5 单都出了图,但 5 单远远不够说明成功率,所以不公布。1K 的几单耗时 6 到 16 秒;4K、一次多张、参考图多的请求会更久,超时请设得宽一些。临时错误请加重试,被拒的提示词改写后再发。
MiniMax H3 Image API 价格
每张输出按尺寸档计价,每张参考图另收固定金额;文字提示不收钱。
| minimax-h3-image | minimax-h3-image-highspeed | |
|---|---|---|
| 每张输出 · 1K 或 2K | $0.03 | $0.05 |
| 每张输出 · 4K | $0.10 | $0.18 |
| 每张参考图 | +$0.01 | +$0.015 |
| 精确尺寸(size 宽x高) | 不超过 5,033,165 像素按 1K / 2K 价,超过按 4K 价 | 规则相同 |
2K 文生图,1 张
$0.03
1 × $0.03
2K 改图,2 张参考图,出 1 张
$0.05
$0.03 + 2 × $0.01
一次出 4 张 2K
$0.12
4 × $0.03;只出成 3 张就收 $0.09
4K 海报,1 张
$0.10
1 × $0.10
标准版还是高速版?
两档的请求写法完全一样:字段、限制、返回都相同,只是模型名、速度和价格不同,换一个字符串就能切换。
| minimax-h3-image | minimax-h3-image-highspeed | |
|---|---|---|
| 我们的 1K 16:9 实测(各测一次) | 文生图约 10 秒;带一张参考图改图约 16 秒 | 带两行文字的海报约 6 秒 |
| 1K / 2K · 4K · 每张参考图 | $0.03 · $0.10 · +$0.01 | $0.05 · $0.18 · +$0.015 |
| 适合 | 批量任务、流水线,没人在等图 | 交互式应用,用户在等结果 |
MiniMax H3 Image 适合做什么,不适合做什么
要用到很多张图的改图
一次最多 16 张参考图:商品、模特、背景、风格参考放在一起,提示词里按「图1、图2」指代。
一次要多个版本
一次调用最多 10 张,只对出成的图收费。
大尺寸和宽幅画面
4K,或最大 2000 万像素的精确尺寸,形状在 1:3 到 3:1 之间任选。
遮罩局部重绘
不支持遮罩。改为在提示词里写清要改什么,把原图作为参考图传入。
透明背景素材
不能输出透明背景。要带透明通道的 PNG,用 doubao-seedream-5-5 并传 background: "transparent"。
要求结果可复现
没有 seed,同一个请求每次出的图都不一样。
一个请求调用
用 apimodels.app 的 API Key 调 POST /v1/images/generations。缺省先返回 taskId,再轮询 GET /v1/images/generations?task_id=(或传 callback_url);传「宽x高」的 size 或用 OpenAI SDK 时,图在同一个响应里返回。完整字段见文档。
curl -X POST https://api.apimodels.app/v1/images/generations \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "minimax-h3-image",
"prompt": "Replace the croissant on the plate with a slice of strawberry cheesecake. Keep the cup, saucer, latte art, steam, table, window light and everything else exactly the same.",
"image": "https://example.com/cafe.jpg",
"resolution": "2K",
"aspect_ratio": "16:9"
}'
# → { "code": 200, "data": { "taskId": "...", "state": "pending", "model": "minimax-h3-image" } }关于 MiniMax H3 Image
MiniMax H3 Image 是由 MiniMax 提供的图片生成 API。MiniMax H3 Image 是 MiniMax 的图像生成模型,在 apimodels.app 上一个 API Key 即可调用,模型名 minimax-h3-image(MiniMax 自己的写法 MiniMax-H3-Image 也认)。一个模型同时做文生图和改图:只传提示词就是文生图;再加 1 到 16 张参考图,提示词里按「图1、图2……」指代,就能改照片的局部、换风格,或把几张图合成一张。每次请求出 1 到 10 张。 尺寸有两种定法:按面积档位 1K / 2K / 4K(缺省 2K)加 auto 或 1:3 到 3:1 之间任意比例;或者直接给精确尺寸,面积在 655,360 到 20,000,000 像素之间。缺省输出 JPEG,也可以要 PNG 或 WebP。文生图默认经过模型的提示词增强,不想要可以用 disable_prompt_enhanced 关掉;改图始终增强。我们实测:1K 16:9 文生图约 10 秒,实得 1360×768;带一张参考图的 1K 改图约 16 秒。 价格:1K、2K 每张 $0.03,4K 每张 $0.10(自定义尺寸超过约 500 万像素按 4K 算),每张参考图另加 $0.01;只对实际出成的图收费,整单失败不扣费。超过约 240 万像素的参考图会先等比缩小再发出。不保证每次都成功:提示词或图片可能被内容审核拒掉。不支持遮罩、透明背景、反向提示词和 seed,传了会直接返回 400,不会被悄悄忽略。要更快出图,用 minimax-h3-image-highspeed。 通过 APIMODELS 平台，您可以使用统一的 API 接口调用该模型，按量计费、价格透明。当前定价：1K: $0.03, 2K: $0.03, 4K: $0.1, Each reference image: +$0.01。
核心功能
- 一个模型,文生图和改图都能做 -- 只给提示词就是文生图;再加 1–16 张参考图(提示词里按「图1、图2」指代),可以改照片局部、换风格或把几张图合成一张
- 1K、2K 或 4K,比例 1:3 到 3:1 -- 按面积档位出图(缺省 2K),比例选 auto 或任意 X:Y;也可以直接给 655,360 到 20,000,000 像素之间的精确尺寸。输出 JPEG、PNG 或 WebP
- 一次 1–10 张 -- n 最多 10,一个响应里全部返回;只对实际出成的图收费
- 每张 $0.03 / $0.10 -- 1K 或 2K $0.03,4K $0.10(自定义尺寸超过约 5 MP 按 4K 算),每张参考图另加 $0.01
- 限制 -- 不支持遮罩、透明背景、反向提示词和 seed,传了直接返回 400,不会被悄悄忽略。参考图最多 16 张,每张宽高 128–8192 px、长边不超过短边 4:1;超过约 2.4 MP 的参考图会先缩小再发出
- 不是 100% 成功,但失败不收钱 -- 不保证每次都成功,内容审核可能拒掉提示词或图片。失败的请求会返回原因,不扣费
分场景示例
适用场景
电商产品图
快速生成高质量产品展示图，适用于电商平台、广告素材等场景。
社交媒体内容
为社交平台创建吸引眼球的视觉内容，提升互动率和品牌曝光。
游戏美术资源
生成游戏角色、场景、道具等概念设计图，加速游戏开发流程。
营销设计素材
制作海报、Banner、宣传图等营销物料，降低设计成本。
为什么选择 APIMODELS
- 统一 API 接口 -- 一个 API Key 调用所有模型，无需分别注册各平台账号
- 价格透明 -- 按量计费，每个模型页公开单次调用价格，适合小微开发者和初创团队
- 即开即用 -- 注册即可使用,支持支付宝、PayPal、银行卡和 USDT 充值
- 完整文档 -- 提供详细的 API 文档和代码示例（cURL、Python、Node.js）
常见问题
APIMODELS 与 MiniMax 官方 API 有什么区别？
APIMODELS 通过聚合平台提供与官方相同的 MiniMax H3 Image 模型。我们提供统一的 API 接口，无需分别注册各平台账号，一个 API Key 即可调用所有模型。
MiniMax H3 Image API 怎么调用?
在 apimodels.app 注册拿一个 API Key,向 POST /v1/images/generations 发请求,model 填 minimax-h3-image(MiniMax 的写法 MiniMax-H3-Image 也认)。不带图就是文生图;带 1 到 16 张参考图(image / images,网址或 base64)就是改图或多图合成,提示词里按「图1、图2」指代。缺省是异步的:先返回 taskId,再用 GET /v1/images/generations?task_id= 轮询,或传 callback_url 等回调;传「宽x高」形式的 size 或用 OpenAI SDK 调用时,图在同一个响应里返回。不需要另开 MiniMax 账号。
MiniMax H3 Image API 多少钱?
每张输出 1K 或 2K $0.03,4K $0.10,每张参考图另加 $0.01,文字提示不收钱。比如 2K 改图带两张参考图、出 1 张是 $0.05;一次出 4 张 2K 文生图是 $0.12。自定义尺寸按面积分档:不超过约 503 万像素按 2K 价,超过按 4K 价。只对实际出成的图收费,整单失败不扣费。
标准版和高速版(minimax-h3-image-highspeed)怎么选?
两者请求写法、参数和限制完全一样,区别是速度和价格。我们各测了一次 1K:高速版出一张海报约 6 秒,标准版文生图约 10 秒。高速版 1K / 2K 每张 $0.05、4K $0.18、每张参考图 $0.015;标准版是 $0.03 / $0.10 / $0.01。批量出图、对时延不敏感用标准版;要尽快把图交给用户用高速版。
MiniMax H3 Image 有哪些限制?
提示词最多 32,000 个字符;一次 1 到 10 张;参考图最多 16 张,每张宽高 128 到 8192 像素、长边不超过短边的 4 倍、不超过 64 MB,超过约 240 万像素的会先等比缩小再发出;比例 1:3 到 3:1;自定义尺寸面积 655,360 到 20,000,000 像素。不支持遮罩局部重绘、透明背景、反向提示词和 seed,传了直接返回 400。关闭提示词增强(disable_prompt_enhanced)只对文生图有效,而且必须同时给比例或尺寸。
不传尺寸时出多大的图?
按 2K 面积出图,比例由模型按提示词决定(auto)。要 1K 或 4K 传 resolution: "1K" / "4K";要固定比例传 aspect_ratio,例如 "16:9";要精确像素传 size,例如 "2720x1536",这时 resolution 和 aspect_ratio 不再起作用。我们实测 1K 16:9 实得 1360×768。
请求失败会怎样?
不保证每次都成功:提示词或图片可能被内容审核拒掉,偶尔也会遇到上游临时出错。一次出多张时只对出成的那几张收费;整单失败不扣费,冻结的额度退回。返回里带失败原因,审核类的改提示词或换图再试,临时错误可以直接重试。
MiniMax H3 Image 支持哪些能力？
MiniMax H3 Image 支持：Text to Image、Image Editing · up to 16 Refs、1K / 2K / 4K、Ratios 1:3 to 3:1、1–10 Images per Request、$0.03–$0.10/image。完整参数与调用方式见 APIMODELS 的 API 文档。
国内能直接调用 MiniMax H3 Image API 吗？需要代理吗？
能直接调用,不需要代理。apimodels.app 和 api.apimodels.app 在中国大陆可以直接访问,注册后用一个 API Key 就能调用 MiniMax H3 Image;不用单独注册模型厂商的账号,也不需要海外信用卡,支付宝就能充值。
怎么充值？支持哪些付款方式？
支持支付宝、PayPal、银行卡(Visa、Mastercard 等,经 Stripe 支付),以及 USDT(TRON 链 TRC20 或 BNB Smart Chain 链 BEP20)。支付宝、PayPal 和银行卡付款后即时到账,USDT 在链上转账确认后到账;也可以开启自动充值。单次充 $50 送 $1,充 $100 送 $3。余额按美元计,按量扣费,没有月费。