跳转到主要内容
POST
当前支持模型：MiniMax-H3-Image、MiniMax-H3-Image-Highspeed，两者参数与限制相同。图像编辑始终开启 Prompt 增强，增强结果见 data[].revised_prompt。
服务端最长等待 600 秒，建议客户端超时不低于 600 秒。本接口不支持幂等：请求发出后，即使客户端超时或断开连接，服务端仍会完成生成并对成功的图片计费；重试会重新生成并计费。使用 OpenAI SDK 时请设置 max_retries=0，关闭默认的自动重试。

授权

​
Authorization
string
header
必填

HTTP: Bearer Auth

  • Security Scheme Type: http
  • HTTP Authorization Scheme: Bearer API_key，用于验证账户信息，可在 账户管理>接口密钥 中查看。

请求体

支持两种写法：application/json，或兼容 OpenAI SDK images.edit 的 multipart/form-data。

​
model
enum<string>
必填

模型名称。可选值：MiniMax-H3-Image、MiniMax-H3-Image-Highspeed，两者参数与限制相同

可用选项:
MiniMax-H3-Image,
MiniMax-H3-Image-Highspeed
​
prompt
string
必填

图片编辑的文本描述，最长 32000 个字符（按 Unicode 字符计，不含首尾空白），为空或只含空白时返回 400。

Maximum string length: 32000
​
images
object[]
必填

参考图列表，1 ~ 16 张。

参考图限制（请求体总大小 ≤ 64 MiB，Base64 编码后的大小约为原文件的 4/3；超过该上限时请改用公网 URL 或 mm_file://）

Required array length: 1 - 16 elements
​
n
integer
默认值:1

生成图片数量，取值范围 [1, 10]，默认 1。

必填范围: 1 <= x <= 10
​
size
string
默认值:auto

输出图片尺寸，默认 auto，详见输出尺寸。两种写法二选一：

  • 宽x高：直接指定宽高，如 2720x1536，宽、高为正整数。面积（宽 × 高）在 655,360 ~ 20,000,000 像素之间，宽高比在 1:3 ~ 3:1 之间，均含边界；不满足时返回 400，不会自动缩放或取整。此时不能再传 aspect_ratio 或 area（传 auto 也不行），否则返回 400
  • auto 或不传：宽高由 aspect_ratio（默认 auto）和 area（默认 4K）决定，两者都可以单独传
​
aspect_ratio
string
默认值:auto

输出宽高比，默认 auto。只能在 size 不传或为 auto 时传入，size 为 宽x高 时传入返回 400。

  • auto：由 Prompt 增强结合参考图与内容决定
  • X:Y：X、Y 为 1 ~ 300 的整数，宽高比在 1:3 ~ 3:1 之间（含边界），如 16:9、3:4、21:9、3:1
示例:

"16:9"

​
area
enum<string>
默认值:4K

输出面积档位，默认 4K。只能在 size 不传或为 auto 时传入，size 为 宽x高 时传入返回 400。

1K、2K、4K 的目标面积分别为 1024 × 1024、2048 × 2048、4096 × 4096 像素，宽高由服务端按宽高比计算，如 2K 搭配 16:9 输出 2720 × 1536。每张的实际宽高见 data[].size。

可用选项:
1K,
2K,
4K
​
output_format
enum<string>
默认值:jpeg

输出图片格式，默认 jpeg。可用值：png、jpeg、jpg、webp。jpg 与 jpeg 等价，响应中的 output_format 返回 jpeg。

可用选项:
png,
jpeg,
jpg,
webp
​
response_format
enum<string>
默认值:url

返回形式，默认 url。

  • url：图片链接，有效期 24 小时，请在有效期内下载并自行保存
  • b64_json：Base64 编码的图片数据，不支持流式

b64_json 的总输出面积（n × 宽 × 高）上限如下，超出返回 400（size 为 auto 时每张按 area 对应的面积计，如 4K 按 4096 × 4096）：

可用选项:
url,
b64_json
​
stream
boolean
默认值:false

是否流式输出，默认 false。开启后响应为 text/event-stream（SSE），仅支持 response_format 为 url：

  • 每张图片处理完推送一个事件：成功为 image_edit.partial_succeeded，失败为 image_edit.partial_failed。事件按完成先后推送，用 image_index 对应张序
  • 全部结束后推送 image_edit.completed，包含 usage 和 request_id
  • 响应头返回后，全部图片失败或提交生成前失败时推送 error 事件
  • 响应头返回前的错误（参数错误、鉴权失败、限流、余额不足等）仍以普通 HTTP 错误返回，与非流式相同；请先检查 HTTP 状态码，再按 SSE 解析

事件结构见流式响应事件。

​
output_compression
integer
默认值:95

压缩质量，取值范围 [0, 100]，默认 95，数值越大画质越高、文件越大。仅对 jpeg / webp 生效，输出 png 时忽略；超出取值范围返回 400。

必填范围: 0 <= x <= 100
​
aigc_watermark
boolean
默认值:false

是否在图片上添加可见的 AIGC 标识水印，默认 false。AIGC 隐式标识（写在图片文件的元数据中）按合规要求写入，不受该参数控制。

响应

stream 为 false（默认）时返回 application/json。stream 为 true 时返回 text/event-stream（SSE），每个事件的 data 为 JSON，结构见 text/event-stream 的响应定义，事件说明与完整示例见流式响应事件。

​
created
integer

响应生成时间，Unix 时间戳（秒）。

​
data
object[]

图片列表，始终为 n 项，按张序排列（与流式事件的 image_index 一致）。成功的项返回 url（或 b64_json）、size 和 revised_prompt；失败的项（包括未通过内容安全检查的）只返回 error。

只要有 1 张成功，HTTP 状态码就是 200，请逐项检查 data[].error；全部失败时返回 402、422 或 500 的错误响应。只对成功的图片计费。

​
output_format
enum<string>

生成图片的格式。

可用选项:
png,
jpeg,
webp
​
usage
object

本次请求的 token 用量，只统计成功的图片，按此计费。total_tokens 为 input_tokens 与 output_tokens 之和。

​
request_id
string

请求 ID（即 Trace ID），反馈问题时请提供。