跳转到主要内容
POST

认证

string
必填
所有接口均使用 Bearer Token 认证。访问 API Key 管理页面 获取密钥。

模型说明

MiniMax H3 Image 擅长写实摄影、海报、产品图和带文字的画面,默认会先把提示词自动扩写成详细的画面描述再出图,扩写后的内容可在查询结果的 revised_prompt 中查看。如需严格按原文出图,可参考 关闭提示词增强。
不传 resolution 时默认输出 4K(约 1600 万像素),单价约为 1K / 2K 的 3.6 倍。不需要 4K 时请显式传入 "resolution": "2K"。

请求参数

string
必填
图像生成模型名称,固定为 minimax-h3-image-highspeed。
string
必填
图像生成或编辑的文本描述。支持中英文,去掉首尾空白后长度为 1 ~ 32,000 个字符。
string[]
参考图数组,最多 16 张。传入后自动进入编辑模式。每一项可以是公网可访问的 http(s):// 直链,也可以是 data:image/png;base64,... 格式的内联 Base64(平台会先转成链接再交给模型)。详见 参考图要求。
string
默认值:"auto"
输出图像的宽高比或精确像素尺寸。支持:
  • auto:由模型根据提示词决定构图和比例
  • 宽高比:X:Y 格式,X、Y 为 1 ~ 300 的整数,比例在 1:3 ~ 3:1 之间(含边界),如 1:1、4:3、16:9、9:16、3:1
  • 精确像素:宽x高,如 2048x1152(兼容 X、×、* 分隔符)
详见 尺寸规则。
string
默认值:"4K"
分辨率档位,与宽高比配合决定实际输出像素。
  • 1K:约 100 万像素
  • 2K:约 420 万像素
  • 4K(默认):约 1600 万像素
兼容小写写法。
size 使用精确像素格式时不能传 resolution,否则返回 400。
integer
默认值:"1"
生成图片数量,取值范围为 1 ~ 10。
boolean
默认值:"true"
是否自动扩写提示词。设为 false 仅对文生图生效,且必须明确指定尺寸,详见 关闭提示词增强。
string
默认值:"jpeg"
输出文件格式。
  • jpeg(默认,也可写作 jpg)
  • png
  • webp
integer
默认值:"95"
压缩质量,范围为 0 ~ 100,对 png 不生效。
boolean
默认值:"false"
是否在图片上添加可见的 AI 生成水印。不影响图片元数据中的隐式标识。
以下参数不支持,传入后会被忽略:quality、style、seed、negative_prompt、background、mask_url。结果一律以 URL 返回,传入 response_format: "b64_json" 会返回 400。

尺寸规则

档位 + 宽高比

档位决定总面积,宽高比决定形状: 实际输出像素由模型按比例和档位取整决定,以返回结果为准。如需精确尺寸,请使用像素写法。

精确像素

使用 size: "宽x高" 时需满足以下条件:
  • ✅ 1024x1024、2048x1152、1536x1536、4000x5000
  • ❌ 512x512(面积太小)、4000x1000(比例超过 3:1)、5000x5000(超过 2000 万像素)

参考图要求

使用 URL 时请确保链接公网可访问。链接无法访问时任务会在生成阶段失败(status 为 failed,费用全额退回)。编辑模式下提示词增强始终开启,不能关闭。

关闭提示词增强

默认情况下模型会先扩写提示词再出图。如需严格按原文出图,可传入 "prompt_optimizer": false,前提是:
  • 只能用于文生图,带有 image_urls 时会返回 400
  • 必须明确指定尺寸:size 需为宽高比(如 1:1)或像素(如 1024x1024),不能为 auto 或不传
关闭后模型约只读取提示词的前 4096 个 token。

Response

integer
响应状态码,提交成功时为 200。
array
提交响应数据。

提交响应

提交成功后会立即返回异步任务 ID:

查询任务结果

使用提交响应中的 task_id 调用 任务查询接口:
极速版出图速度快于标准版(标准版实测单张 1K / 2K 约 10 ~ 20 秒、4K 约 20 秒)。建议每 3 ~ 5 秒轮询一次,直到状态变为 completed 或 failed。单个任务最长可运行 600 秒,客户端轮询超时建议设为 10 分钟。

任务成功

图片地址位于 data.result.images[0].url[],n 张图都在这一个数组中,请在 expires_at 前下载转存。任务失败时 status 为 failed,原因见 error.message,费用会自动全额退回。

使用示例

文生图(默认 4K)

文生图(1K + 宽高比,一次 4 张)

精确像素 + PNG

参考图编辑

关闭提示词增强