编辑图片

POST/v1/images/edits

上传参考图并根据提示词编辑图片。

Authorization

bearerAuth

AuthorizationBearer <token>

使用平台 API Key，格式为 Authorization: Bearer your-api-key。

In: header

Request Body

multipart/form-data

TypeScript Definitions

Use the request body type in TypeScript.

model*string

平台模型 ID。

prompt*string

图片编辑指令，始终开启提示词增强。按 Unicode 字符计，不含首尾空白；内容不能全为空白。

Length1 <= length <= 32000

n?integer

生成图片数量。

Range1 <= value <= 10

Default1

size?string

auto 或宽x高，默认 auto。自定义面积为 655,360–20,000,000 像素，宽高比为 1:3–3:1；指定宽高时省略 aspect_ratio 和 area。

Default"auto"

aspect_ratio?string

默认 auto，由增强后的提示词决定；编辑时结合参考图。也可传 X:Y，X、Y 为 1–300 的整数，比值为 1:3–3:1。仅在 size 省略或为 auto 时使用。

area?string

面积档位，默认 4K。仅在 size 省略或为 auto 时使用，实际宽高见 data[].size。

Value in

"1K"
"2K"
"4K"

output_format?string

图片格式。jpg 与 jpeg 等价，响应统一返回 jpeg。

Default"jpeg"

Value in

"jpeg"
"jpg"
"png"
"webp"

response_format?string

url 链接有效期 24 小时；b64_json 返回 Base64 且不能流式。Base64 总输出面积上限为 PNG 20,000,000 像素、JPEG／WebP 80,000,000 像素，按张数合计。

Default"url"

Value in

"url"
"b64_json"

output_compression?integer

JPEG／WebP 压缩质量，数值越高文件越大；PNG 忽略此项。

Range0 <= value <= 100

Default95

stream?boolean

是否使用 SSE 逐张返回结果，仅支持 response_format 为 url。

Defaultfalse

aigc_watermark?boolean

是否添加可见 AIGC 水印，不影响文件元数据中的隐式标识。

Defaultfalse

image*array<>

参考图 1–16 张。支持 JPG、JPEG、PNG、WEBP、HEIC、HEIF，单图及整个请求体各不超过 64 MiB；边长 128–8192 像素，长短边比不超过 4:1。Base64 编码也计入请求体大小。每张文件一个 image 字段，多图也可使用 image[]；上传顺序对应图号。

Items1 <= items <= 16

JSON 图片引用

JSON 请求使用 images 对象数组提交参考图，其余字段与文件上传方式相同。

字段	JSON 写法
`images[].image_url`	必填，支持公网 URL、Base64 Data URL 或 mm_file://{file_id}。URL 示例可替换为文生图生成并保存的图片地址。

Response Body

`application/json`

type*string

created?integer

事件的 Unix 时间戳。

model?string

实际使用的模型 ID。

image_index*integer

图片序号，从 0 开始。

Range0 <= value

url*string

生成图片的临时链接。

size?string

图片实际宽x高。

output_format?string

实际输出格式。

Value in

"jpeg"
"png"
"webp"

revised_prompt?string

该张图片使用的提示词。

curl -X POST "https://api.agtcloud.ai/v1/images/edits" \
  -H "Authorization: Bearer your-api-key" \
  -F model="MODEL_ID" \
  -F prompt="把台灯的绿色灯罩改成米白色，保留木桌、背景、光线和构图。" \
  -F size="2048x2048" \
  -F n="1" \
  -F response_format="url" \
  -F image="@/path/to/lamp.png"

{
  "created": 1794355200,
  "data": [
    {
      "url": "https://example.com/lamp-result.jpg",
      "size": "2048x2048",
      "revised_prompt": "浅色墙面前的木桌上摆放着一盏绿色台灯，柔和自然光照亮灯罩与桌面。"
    }
  ],
  "output_format": "jpeg",
  "request_id": "REQUEST_ID"
}

客户端超时建议不低于 600 秒。请求超时或断开后，服务端可能继续生成；再次发送会创建新的请求。

MiniMax 编辑图片 API查看请求参数与响应结构。

Authorization

Request Body

JSON 图片引用

Response Body

200application/json

400application/json

401application/json

402application/json

422application/json

429application/json

流式响应事件

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`