Create image edit
最近更新:2026年11月23日
通过 multipart/form-data 请求调用 openai/gpt-image-2.6-sunburst 基于参考图、蒙版或涂鸦标注编辑高画质图像。
调用 openai/gpt-image-2.6-sunburst 基于一张或多张参考图像执行高保真编辑或合成。请求体采用 multipart/form-data 格式:参考图像(image / image[])、可选局部蒙版(mask)或 2.6 新增的视觉标注图(markup)作为二进制文件上传,其余参数作为表单字段传递。
https://gateway.amux.ai/v1/images/edits鉴权
headerAuthorizationstring必填Bearer <你的 Amux AI 密钥> Amux AI API 密钥(Bearer Token)。
请求
multipart/form-datamodelstring必填模型 ID(可附加 :amux-special 或 :adobe 后缀)。
promptstring必填图像编辑指令提示词,上限 32,000 字符。
imagearray<string>必填参考图像文件列表,最多 16 张,单张文件大小上限 25 MB。
字段名同时兼容 image 与 image[](OpenAI 官方 SDK 在单图与多图场景下分别使用这两种命名)。
maskstring局部编辑蒙版文件,透明区域(alpha 为 0)指示需要重绘的区域。与 markup 互斥。须满足:
1. 必须为包含 alpha 通道的 PNG 文件;
2. 像素尺寸须与原图完全一致,且文件大小不超过 4 MB;
3. 传入多张参考图时,蒙版仅作用于第一张参考图。
渠道支持说明:adobe 渠道不支持 mask;未显式锁定 :adobe 时会自动跳过 adobe 路由至 amux-special,锁定 :adobe 将返回 400。
markupstringGPT-Image 2.6 新增的视觉涂鸦/圈选标注图,用于在原图上以画笔、箭头或文字标注需要修改的局部区域。与 mask 互斥,仅在同时上传参考图像时生效。
渠道支持说明:adobe 渠道不支持 markup(显式锁定 :adobe 将返回 400);amux-special 渠道已支持。
ninteger默认 1生成图像张数(1–10,默认 1);流式模式下必须为 1。
sizestring默认 "1024x1024"输出图像像素尺寸,默认 1024x1024。支持 auto、常用标准规格或任意符合生成端点像素约束的自定义规格。adobe 严格要求总像素 ≥ 655,360;amux-special 非 4K 规格按比例输出约 1.57MP、4K 为超分。
aspect_ratiostring宽高比(1:1 / 4:3 / 3:4 / 3:2 / 2:3 / 16:9 / 9:16),作为 size 的替代写法。建议优先使用 size;同时提供时以 size 为准,折算或忽略说明记录于 amux.notes。
image_sizestring分辨率档位(1K / 2K / 4K),与 aspect_ratio 配合使用,折算规则同 aspect_ratio。
quality"low" | "medium" | "high" | "xhigh" | "max" | "auto"默认 "auto"low / medium / high / xhigh / max / auto。
complexity"low" | "medium" | "high"默认 "high"GPT-Image 2.6 新增参数,控制构图与细节复杂度(low / medium / high,默认 high)。amux-special 与 adobe 渠道均已支持。
background"transparent" | "opaque" | "auto"默认 "auto"背景模式(transparent / opaque / auto)。透明背景须搭配 png 或 webp 格式。
output_format"png" | "jpeg" | "webp"默认 "png"输出图像格式(png / jpeg / webp,默认 png)。编辑端点不支持 svg 与 gif。
output_compressionstring图像压缩比(0–100,默认 100),仅对 jpeg 与 webp 格式生效。
userstring终端用户唯一标识,用于异常调用识别与滥用防控。
stream"true" | "false"是否启用 SSE 流式返回。multipart/form-data 表单字段需传入字符串 'true' 或 'false'。渠道支持说明:当前已上线的 amux-special 与 adobe 渠道均不支持流式传输,待 openai / azure 官方渠道上线后可用。
partial_imagesstring流式模式下返回的低清预览图像数量上限(0–3,默认 0)。渠道支持说明:依赖流式传输,当前 amux-special 与 adobe 渠道均不支持。
响应
200response图像编辑成功,响应结构与图像生成端点一致。
400response请求参数无效(如同时传入 mask 与 markup、请求 svg/gif、所选渠道不支持 mask/markup/stream,或流式模式下 n > 1)。
402response工作区可用余额不足以覆盖本次请求的预留额度。
503response当前并发任务已达上限或服务暂时不可用,请稍后重试。
供应商差异与可用状态
| 供应商 | 状态 | 计费方式 | 编辑能力差异 | 不支持的参数 |
|---|---|---|---|---|
amux-special | 已上线 | 低价按次计费 | 支持多图参考、mask 与 markup 涂鸦标注编辑 | stream、partial_images |
adobe | 已上线 | 偏低价按次计费(略高于 amux-special) | 仅支持常规参考图编辑,原生 4K 输出 | mask、markup、stream、partial_images |
openai | 暂未上线 | 官方按 token 计费 | 官方全量编辑能力 | —(上线后启用) |
azure | 暂未上线 | 官方 Azure 按 token 计费 | 官方全量编辑能力 | —(上线后启用) |
未显式锁定供应商时,传入 mask 或 markup 会自动跳过 adobe 并路由至 amux-special;显式锁定 :adobe 且携带 mask 或 markup 时,网关将直接返回 400。
参考图像、mask 与 markup 约束
- 参考图像字段名同时兼容
image与image[],单次请求最多上传 16 张,单张文件上限 25 MB。 mask与markup互斥:两者不可在同一请求中同时上传,否则网关直接返回400。mask须为包含 alpha 通道的 PNG 文件(透明区域表示重绘范围),像素尺寸与第一张原图一致且文件大小 ≤ 4 MB;adobe渠道不支持。markup为 GPT-Image 2.6 新增的涂鸦/圈选标注图,可在原图上直接以画笔、箭头或文字圈出改动意图;adobe渠道不支持,amux-special渠道已支持。- 编辑端点仅支持
png、jpeg、webp输出格式,不支持svg与gif。
关于 input_fidelity
GPT-Image 2.6 系列不接受 input_fidelity 参数。为兼容从 gpt-image-1.5 迁移的调用方,网关在转发前会自动移除该字段并在 amux.notes 中记录说明。
异步编辑
将相同表单参数提交至 /v1/tasks(multipart/form-data)即可切换为异步任务执行,请参阅 Create task。
流式传输
当前已上线的 amux-special 与 adobe 供应商均不支持编辑流式传输(stream=true 会返回 400),待 openai / azure 官方渠道上线后可用。
错误处理
错误响应结构与 OpenAI 官方规范一致,type 取值与重试策略见错误与重试。
curl https://gateway.amux.ai/v1/images/edits \
-H "Authorization: Bearer $AMUX_API_KEY" \
-F "model=openai/gpt-image-2.6-sunburst" \
-F "prompt=<string>" \
-F "image=@/path/to/image.png" \
-F "mask=@/path/to/mask.png" \
-F "markup=@/path/to/markup.png" \
-F "n=1" \
-F "size=1024x1024" \
-F "aspect_ratio=<string>" \
-F "image_size=<string>" \
-F "quality=auto" \
-F "complexity=high" \
-F "background=auto" \
-F "output_format=png" \
-F "output_compression=<string>" \
-F "user=<string>" \
-F "stream=true" \
-F "partial_images=<string>"{
"created": 1786000000,
"data": [
{
"b64_json": "<string>",
"revised_prompt": "<string>"
}
],
"usage": {
"input_tokens": 0,
"output_tokens": 0,
"total_tokens": 0
},
"amux": {
"task_id": "<string>",
"generation_id": "<string>",
"provider": "<string>",
"cost_nano": "<string>",
"images": [
{
"index": 0,
"url": "<string>"
}
],
"notes": [
"<string>"
]
}
}