MiniMax H3-Image:文生图接口确认了什么,开放权重与编辑还缺哪些证据
已读官方文档列出了 MiniMax H3-Image 的文生图参数、输出限制与重试计费风险,但不足以确认发布日期、开放权重许可或参考图编辑方式。本文区分可核对的接口事实与仍待补证的采用条件。
·

搜索 minimax h3 image,容易把几个不同的问题放在一起:模型是否发布、权重是否开放、能否编辑图片,以及接口能否直接用于生产。现有已读资料只能支持其中一部分:MiniMax 官方文生图文档列出了 H3-Image 的请求方式和限制,但不能单独证明开放权重、编辑能力或部署条件。
这里依据的是已取得的官方 Text-to-Image 文档,不是接口实测。资料取得时间为 2026 年 11 月 16 日,页面更新时间未知。建议方向提到的“11 月 11 日发布”和开放权重定位,尚缺公告及模型卡正文核验,本文不将其写成已确认新闻。
文生图已有哪些明确接口信息
文档列出的端点是 POST https://api.minimax.io/v1/images/generations,采用 Bearer API key 鉴权。模型可选 MiniMax-H3-Image 和 MiniMax-H3-Image-Highspeed,两者采用相同参数与限制。名称中的 Highspeed 本身不能证明具体提速幅度或画质差异。
| 项目 | 文档明确的信息 | 使用时的含义 |
|---|---|---|
| 提示词 | 必填,最多 32,000 个 Unicode 字符,不计首尾空白 | 关闭提示词增强时,模型只读取约前 4,096 tokens;字符上限不等于有效上下文长度 |
| 单次图片数 | n 为 1–10,默认 1 | 不代表任意数量、尺寸和返回格式组合都有效 |
| 指定宽高 | 面积为 655,360–20,000,000 像素,宽高比为 1:3–3:1,均含边界 | 使用 WIDTHxHEIGHT 时不能同时传 aspect_ratio 或 area,即使值为 auto |
| 面积档位 | area 可为 1K、2K、4K,默认 4K | 档位表示目标面积,不保证长边固定为对应数字 |
| 输出与返回 | 文件格式有 PNG、JPEG、WebP;返回方式有 URL 或 Base64 | 流式返回仅支持 URL,URL 不保证长期可用 |
以上限制均见官方参数说明。例如,文档把 2K 与 16:9 对应的输出写为 2720×1536;判断实际宽高应读取每张图片的 data[].size,而不是只看档位名称。
Base64 还有整次请求的总输出面积限制:PNG 为 20,000,000 像素,JPEG/WebP 为 80,000,000 像素。因此,n 没有超过 10,并不意味着请求一定满足返回格式限制。
比参数更需要注意的是失败与重试
文档说明,服务端最多等待 600 秒,客户端超时应设为至少 600 秒。接口不是幂等的:客户端超时或断开连接后,服务端仍会完成生成并对成功图片计费;重试会再次生成、再次计费。使用 OpenAI SDK 时,文档要求设置 max_retries=0,关闭默认自动重试。
这意味着,客户端没有收到结果,不等于服务端没有执行。接入时不应把超时直接当成“可以无成本重发”的信号。
同样,HTTP 200 不等于每张图片都成功。只要至少一张成功,接口就可能返回 200;失败项仅含 error,需要逐项检查 data[].error。文档说明仅成功图片收费,但没有在已读正文中给出可据以计算实际费用的单价。用量字段不能代替价目表。
参考图、编辑与开放权重,不能由这份文档推导
已取得的页面描述的是文生图端点,参数中没有提供可供本文核对的参考图上传、遮罩编辑或局部修改流程。这不能证明模型不支持这些能力,只能说明当前证据尚未确认它们如何使用。
开放权重也需要另一组证据。API 可调用,不等于权重可下载;权重可下载,也不自动等于允许任意商业使用。本地部署还需要可核对的运行代码、硬件要求和精度配置,不能从 API 的输出尺寸反推显存需求。
若要把本文扩展为完整发布新闻,仍需取得并读取官方公告、模型卡及许可正文,确认发布时间、权重提供方式、商业使用条件和部署要求;参考图与编辑能力则需要对应端点文档。当前可以据此准备文生图接入评估,但不能据此作出本地部署、商业授权或编辑功能已可用的判断。