Amux AI

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)作为二进制文件上传,其余参数作为表单字段传递。

POSThttps://gateway.amux.ai/v1/images/edits

鉴权

header
Authorizationstring必填

Bearer <你的 Amux AI 密钥> Amux AI API 密钥(Bearer Token)。

请求

multipart/form-data
modelstring必填

模型 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。

markupstring

GPT-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
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>"
    ]
  }
}