作者注：MiniMax H3-Image 规格拆解：约 16MP 直出、6 步蒸馏、最多 16 张参考图。本文区分文档说明与官方自报，并附上接口要点、开源协议边界与 API易 上架状态。
MiniMax 于 2026-11-10 通过官方 X 账号发布了 MiniMax H3-Image。这是一款开放权重的图像生成与编辑模型，生成和编辑共用同一个 checkpoint。它有三个特点：约 16MP 分辨率直出且不经过放大器，蒸馏到 6 步推理，最多支持 16 张参考图。截至 2026-11-11，API易（apiyi.com）的型号列表里还没有这个型号，接入方式和价格要等上架后再看。
这篇不是对发布帖的转述。下文每个数字都标了来源：模型卡和接口文档里写明的规格标为「文档说明」，官方评测、官方博客和官方账号里的宣传数字标为「官方自报」，暂时无法确认的内容单独列出。
核心价值：读完本文，你会得到一张 MiniMax H3-Image 的能力边界表，覆盖分辨率、步数、参考图、开源范围以及现在能不能在 API易 调用。你可以据此判断它要不要排进自己的图像 API 选型表。
MiniMax H3-Image 核心信息速览
先把发布信息压缩成一张表。表里「来源」一列很重要，后面所有判断都建立在这一列上。
| 信息项 | 详情 | 来源 |
|---|---|---|
| 发布时间 | 2026-11-10 15:40 UTC，官方 X 账号 @MiniMax_AI 发帖 | 官方账号 |
| 发布方 | MiniMax | 官方账号 |
| 模型类型 | 图像生成与编辑，同一个 checkpoint，开放权重 | 文档说明（模型卡） |
| 模型 ID | MiniMax-H3-Image、MiniMax-H3-Image-Highspeed |
文档说明（接口文档） |
| 使用入口 | MiniMax API、MiniMax Code、Hailuo AI | 官方账号 |
| 开源协议 | MiniMax-H3-Image Community License，有适用地域限制 | 文档说明（模型卡） |
| API易 状态 | 暂未上架，我们会尽快上架这个模型；型号与价格以平台型号列表为准。 | API易 型号列表，2026-11-11 |
发布帖的标题是「4K image generation in 10 seconds」。「10 秒出 4K」属于官方自报，它是官方账号的宣传说法，不是接口 SLA。接口文档写的是服务端最多等待 600 秒，做超时和排队设计时应该以 600 秒为准，而不是 10 秒。
MiniMax H3-Image 规格、来源与待确认项
这一节回答一个问题：哪些数字可以直接写进技术方案，哪些只能当参考。下表按「规格 / 来源 / 还不确定」三列整理。
| 规格 | 来源 | 还不确定 |
|---|---|---|
| 约 16MP 直出，从 4096×4096（1:1）到 6272×2688（21:9），不经过放大器 | 文档说明（模型卡） | 不同比例下的细节保真度没有独立评测 |
| 蒸馏到 6 步（6 NFE），不使用 classifier-free guidance | 文档说明（模型卡） | 6 步在复杂构图上的稳定性缺少第三方数据 |
| DiT 33.1B 参数，50 层，BF16 | 文档说明（模型卡） | 量化版本和显存下限未见官方说明 |
| 最多 16 张参考图 | 官方自报（模型卡、官方账号） | 参考图数量增加后，一致性如何变化 |
| 开源模型里指令跟随最强 | 官方自报（模型卡） | 没有独立榜单分数，无法横向核对 |
| 10 秒生成 4K | 官方自报（官方账号） | 不是接口承诺，接口超时是 600 秒 |
| Highspeed 与标准版参数上限相同 | 文档说明（接口文档） | 两者的具体速度差文档未给数字 |
看完这张表可以得出一个结论：MiniMax H3-Image 的硬规格（分辨率区间、步数、参数量）有文档支撑，比较可靠。真正需要打问号的是「指令跟随最强」和「10 秒出 4K」这类表述，目前只有官方自报，没有独立复核。
MiniMax H3-Image 16MP 直出：尺寸怎么选
「16MP 直出」指的是模型在原生分辨率上一次生成，不再先出小图、再用超分模型放大。按模型卡说明，它的有效工作区大约在 4MP 到 20MP 之间，16MP 附近效果最好。下面是模型卡给出的常用 16MP 尺寸，竖图把宽高对调即可。
| 比例 | 横图尺寸 | 像素量（约） |
|---|---|---|
| 1:1 | 4096×4096 | 16.8MP |
| 4:3 | 4736×3552 | 16.8MP |
| 3:2 | 5024×3360 | 16.9MP |
| 16:9 | 5472×3072 | 16.8MP |
| 21:9 | 6272×2688 | 16.9MP |
这些尺寸对印刷物料、横幅海报、电商长图这类需要大画幅的场景比较友好，可以省掉一次超分后处理。代价是单张图文件更大，存储和传输成本要提前算进流水线。
MiniMax H3-Image 6 步蒸馏意味着什么
模型卡写明 MiniMax H3-Image 蒸馏到 6 步（6 NFE），而且不使用 classifier-free guidance。少一次无条件分支计算，加上步数压到 6，是它能宣称快速出大图的技术基础。
这个设计也带来一个直接限制：步数和引导系数基本是固定的。按文档说明，本地推理时 num_inference_steps 只能是 6 或省略，guidance_scale 只能是 1 或省略，negative_prompt 会被直接拒绝。习惯靠加步数、调 CFG、写负向提示词来控图的开发者，需要把控制手段转移到正向提示词和参考图上。
MiniMax H3-Image 参考图与生成编辑一体
生成和编辑共用同一个 checkpoint，这一点属于文档说明。对接入方来说，维护一个模型就能同时覆盖文生图和改图，不必为编辑任务单独部署权重。最多 16 张参考图则属于官方自报，适合多角色一致性、多商品组合、品牌元素拼接这类任务。不过参考图越多，一致性能否保持，目前还没有第三方数据。
模型卡还提到一个可选的提示词扩展模型 MiniMax-H3-Image-PE，用来把简短提示词扩写成更完整的描述。它是可选组件，不装也能正常推理。
MiniMax H3-Image 接口与部署要点
接口文档把文生图和编辑拆成了两条路径。下面按接入时最容易踩坑的顺序列出要点，全部属于文档说明：
- 文生图路径：
POST /v1/images/generations - 编辑路径：
/v1/images/edits，和文生图是两条接口 - 模型 ID：
MiniMax-H3-Image、MiniMax-H3-Image-Highspeed，两者参数上限相同 - 数量
n：1 到 10 - 尺寸
size：传WIDTHxHEIGHT时，面积须在 655,360 到 20,000,000 像素之间，宽高比在 1:3 到 3:1 之间 - 尺寸省略或
auto：面积默认 4K；1K、2K、4K分别对应 1024×1024、2048×2048、4096×4096 的目标面积 - 提示词增强：默认开启；设置
disable_prompt_enhanced为true时，必须自己指定比例 - 输出格式：
png、jpeg、webp，默认jpeg - 服务端等待上限：600 秒
本地部署要把显存和磁盘算清楚。模型仓库里的 DiT 约 68.65GB，文本编码器来自 MiniMax-H3、基于 Qwen3-VL，不在同一个仓库里，单独约 66.7GB。两者加起来，BF16 权重超过 135GB。
MiniMax H3-Image 开源协议的边界
「open-weight」不等于随便商用。MiniMax H3-Image 采用 MiniMax-H3-Image Community License，许可证日期为 2026-11-10。协议写明适用范围是 Applicable Territory，也就是存在地域限制。超出协议范围的使用需要额外的书面授权，申请入口在 MiniMax 平台控制台的 license 页面。
因此，打算在商业产品里自托管权重的团队，应该先逐条读完协议，确认所在地区和使用方式都在授权范围内。拿不准时再走额外授权申请，不要默认「开源即可商用」。
MiniMax H3-Image 现在能在 API易 调吗
结论是暂时不能。2026-11-11，我们核对了 API易 apiyi.com 的型号文档和价目接口：平台已上架 MiniMax-H3 视频模型，但还没有 MiniMax-H3-Image，也没有 MiniMax-H3-Image-Highspeed。
下表把 MiniMax H3-Image 相关型号和平台上已能调用的邻近图像型号放在一起，方便对照。需要说明的是，已上架的邻近型号是各自独立的模型，不是 MiniMax H3-Image 的替代名或别名。
| 型号 | API易 状态 | 计费方式 | 输入价 | 输出价 | 缓存读价 |
|---|---|---|---|---|---|
MiniMax-H3-Image |
暂未上架 | — | — | — | — |
MiniMax-H3-Image-Highspeed |
暂未上架 | — | — | — | — |
| Seedream 5.5 | 暂未上架 | — | — | — | — |
| MiniMax-H3（视频） | 已上架 | 按秒 | — | $0.03 / 秒 | 无缓存读价 |
gemini-nano-banana-2.1 |
已上架 | 按次 | — | $0.045 / 次 | 无缓存读价 |
gpt-image-2.6-flare |
已上架 | 按量 | 文本 $5、图片 $8 | $30 | 文本 $1.25、图片 $2 |
gpt-image-2.6-sunburst |
已上架 | 按量 | 文本 $5、图片 $8 | $30 | 文本 $1.25、图片 $2 |
按量计费型号的价格单位为每百万 token，数据日期 2026-11-11。MiniMax-H3-Image、MiniMax-H3-Image-Highspeed 和 Seedream 5.5 暂未上架，我们会尽快上架这个模型；型号与价格以平台型号列表为准。已上架型号同样以平台型号列表为准。MiniMax 官方对 H3-Image 的定价不在本文参考资料范围内，这里不列具体数字，也就没有可写的缓存读价。
上图中的状态和价格来自 API易 apiyi.com 的价目接口，日期 2026-11-11。谷歌这一侧，按本文口径最新的图片模型是 Nano Banana 2.1，对应平台型号 gemini-nano-banana-2.1。
🚀 接入建议：如果你的图像流水线现在就要跑起来，可以先用平台上已上架的图像型号把调用链路搭好。这些型号走 OpenAI 兼容接口，
base_url填https://api.apiyi.com/v1。等 MiniMax H3-Image 上架后，通常只需要替换模型 ID，再按它的尺寸规则调整size参数，链路本身不用重写。
MiniMax H3-Image 接入排错三条
下面三条都来自接口文档，是接入 MiniMax H3-Image 时最容易出问题的地方：
- 超时后不要盲目重试：请求不是幂等的。客户端超时以后，服务端仍可能继续出图并扣费；这时候重试，会再出一张、再扣一次。文档建议用 OpenAI SDK 时把
max_retries设为0，同时把客户端超时调到能覆盖服务端 600 秒的等待上限。超时后先查账单和任务记录，再决定要不要补发。 - 错误码
2068是套餐档问题：它表示当前套餐档不支持该模型，不是参数写错，也不是服务故障。改请求体解决不了，需要升级套餐或换用支持的型号。 negative_prompt和改步数会被拒：按文档说明，num_inference_steps只能是 6 或省略，guidance_scale只能是 1 或省略，negative_prompt会被直接拒绝。从其他扩散模型迁移过来的调用代码，要先删掉这几个参数。
MiniMax H3-Image 影响分析
对开发者的影响
- 大画幅不再依赖超分：约 16MP 直出可以去掉「小图生成 + 放大器」两段式流程，减少一个模型的维护成本。
- 控图方式要换：步数、CFG 和负向提示词都被锁住，控图主要靠正向提示词、参考图和比例参数。现有提示词模板需要重写。
- 超时与计费策略要改：非幂等请求加上 600 秒的等待上限，要求客户端改用「长超时 + 不自动重试 + 对账」的策略。
- 自托管门槛不低：超过 135GB 的 BF16 权重，加上协议的地域限制，中小团队更现实的路径是走 API。对已经在 API易 apiyi.com 上跑图像流水线的团队来说，上架后在同一个 Key 下切换型号的成本最低。
对行业的影响
- 开放权重图像模型的规格上限被抬高：33.1B 参数的 DiT 搭配 16MP 原生输出，让开放权重模型在大画幅场景里有了更直接的选项。
- 「开源」与「可商用」的区分会更常见：社区许可证加适用地域限制，说明在大模型开源里，授权条款本身已经是选型的一部分，不能只看「open-weight」这个标签。
- 宣传数字与接口承诺需要分开看：「10 秒出 4K」和「600 秒超时」同时存在，提醒选型方以接口文档为准，把宣传数字只当作参考。
常见问题 FAQ
Q1: 什么是 MiniMax H3-Image？
MiniMax H3-Image 是 MiniMax 于 2026-11-10 发布的开放权重图像模型，生成和编辑共用同一个 checkpoint。按文档说明，它能约 16MP 直出、蒸馏到 6 步；最多 16 张参考图属于官方自报。
Q2: MiniMax H3-Image 真的 10 秒出 4K 吗？
这是官方账号的说法，属于官方自报，不是接口承诺。接口文档写的服务端等待上限是 600 秒，做系统设计时应以 600 秒为准。
Q3: MiniMax H3-Image 开源了，能直接商用吗？
不能一概而论。它采用 MiniMax-H3-Image Community License，适用范围限定在 Applicable Territory。超出范围需要通过 MiniMax 平台的 license 页面申请额外的书面授权，商用前应逐条核对协议。
Q4: 如何通过 API易 调用 MiniMax H3-Image？
截至 2026-11-11 暂未上架，我们会尽快上架这个模型；型号与价格以平台型号列表为准。上架后可以在 API易 apiyi.com 用同一个 API Key，以 OpenAI 兼容方式调用。在此之前，可以先用平台上已上架的图像型号把调用链路搭好。
Q5: MiniMax-H3-Image 和 MiniMax-H3-Image-Highspeed 怎么选？
文档说明两者的参数上限相同。名称上看，Highspeed 偏向速度，但文档没有给出具体的速度差和画质差。建议等两者都能调用后，用自己的提示词做对照，再决定用哪个。
Q6: MiniMax H3-Image 有哪些已知限制？
– 步数固定为 6，引导系数固定为 1，不支持 negative prompt。
– 请求不幂等，超时重试可能重复扣费。
– 错误码 `2068` 表示套餐档不支持该模型。
– 自托管权重总量超过 135GB，且协议有地域限制。
– 「指令跟随最强」目前只有官方自报，没有独立榜单分数。
MiniMax H3-Image 核心要点 Key Takeaways
- 类型定位：开放权重图像模型，生成和编辑共用一个 checkpoint。
- 分辨率：约 16MP 直出，4096×4096 到 6272×2688，不经放大器。
- 推理步数：蒸馏到 6 步，不使用 CFG，步数与引导系数不可调。
- 参考图：最多 16 张，属于官方自报，一致性有待第三方验证。
- 接口要点：生成与编辑分两条路径，超时 600 秒，请求不幂等。
- 开源边界：社区许可证有适用地域限制，额外商用需书面授权。
- 上架状态：API易 暂未上架，型号与价格以平台型号列表为准。
总结
MiniMax H3-Image 的核心要点：
- 硬规格可靠：约 16MP 直出、6 步蒸馏、33.1B DiT 都有模型卡支撑，可以直接写进选型表。
- 宣传数字要打折：「10 秒出 4K」和「指令跟随最强」属于官方自报，接口超时以 600 秒为准。
- 接入有三个坑：超时不要盲目重试，
2068是套餐档问题，negative_prompt和改步数会被拒。 - 开源有边界：社区许可证加地域限制，商用前必须核对条款。
如果你需要大画幅、多参考图的图像生成能力，MiniMax H3-Image 值得排进候选名单，但建议先按本文的能力边界表做一轮文档复测再下结论。上架进度可以关注 API易 apiyi.com 的平台型号列表，在它上架之前，可以先用已上架的图像型号把流水线跑通。
📚 参考资料
- MiniMax 官方 X 账号发布帖：MiniMax H3-Image 发布公告
- 链接：
x.com/MiniMax_AI/status/2120179737695826420 -
说明：「10 秒出 4K」「16 张参考图」等宣传说法的出处，属于官方自报
-
Hugging Face 模型卡：MiniMax-H3-Image 权重与规格
- 链接：
huggingface.co/MiniMaxAI/MiniMax-H3-Image -
说明：分辨率、步数、参数量、常用尺寸与社区许可证
-
MiniMax 图像生成接口文档：H3 文生图接口参考
- 链接：
platform.minimax.io/docs/api-reference/image-generation-h3-generations -
说明：模型 ID、
size规则、超时、幂等性与错误码2068 -
MiniMax 额外授权申请：社区许可证之外的书面授权
- 链接：
platform.minimax.io/console/license -
说明：超出 Applicable Territory 时的申请入口
-
API易 型号列表：平台可用型号与上架状态
- 链接：
docs.apiyi.com/models - 说明：本文上架状态与价格的核对来源，数据日期 2026-11-11
作者：APIYI 技术团队
技术交流：如对图像模型的接入有疑问，欢迎在 API易 网站首页联系我们，型号与价格以平台型号列表为准
