编辑图片

根据一张或多张源图片和文本提示词，创建编辑或扩展后的图片。该接口支持 GPT Image 模型以及 dall-e-2。

接口信息

模型选择

下方调用示例使用按次模型；如需使用官方模型，替换请求中的 model 参数即可。

调用示例

curl https://token.aiznt.com/v1/images/edits \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-你的aiznt密钥" \
  -d '{
    "images": [
      {
        "image_url": "https://example.com/source-image.png"
      }
    ],
    "prompt": "Add a watercolor effect to this image",
    "model": "gpt-image-2.5-sunburst",
    "quality": "high",
    "size": "1024x1024"
  }'

{
  "created": 0,
  "background": "transparent",
  "data": [
    {
      "b64_json": "b64_json",
      "revised_prompt": "revised_prompt",
      "url": "https://example.com"
    }
  ],
  "output_format": "png",
  "quality": "low",
  "size": "1024x1024",
  "usage": {
    "input_tokens": 0,
    "input_tokens_details": {
      "image_tokens": 0,
      "text_tokens": 0
    },
    "output_tokens": 0,
    "total_tokens": 0,
    "output_tokens_details": {
      "image_tokens": 0,
      "text_tokens": 0
    }
  }
}

请求参数

输入与模型

images

类型：object[]，必填

要编辑的输入图片引用。GPT Image 模型最多可以提供 16 张图片。数组中的每个对象支持以下字段：

使用 multipart/form-data 上传本地文件时，以 image[] 字段传入一张或多张图片。

prompt

类型：string，必填

对所需图片编辑效果的文本描述，长度为 1 至 32,000 个字符。

background

类型："transparent" | "opaque" | "auto" | null，可选

设置输出图片的背景。opaque 表示不透明背景，transparent 表示透明背景，auto 表示自动选择。

gpt-image-2.5-sunburst、gpt-image-2.5-flare 及其 2026-09-08 日期快照支持 opaque 和 transparent。其他支持透明背景的 GPT Image 模型也可以使用 transparent；gpt-image-2 和 gpt-image-2-2026-04-21 的透明背景功能目前处于预览阶段。使用 transparent 时，须将 output_format 设置为 png 或 webp。

input_fidelity

类型："high" | "low" | null，可选

控制生成结果对原始输入图片的保真度。

mask

类型：object | null，可选

通过 URL 或已上传文件的 ID 引用遮罩图片。必须且只能提供 image_url 或 file_id 其中一个字段。

model

类型：string | null，可选

用于编辑图片的模型。平台模型名称分为：

• 按次模型：gpt-image-2、gpt-image-2.5-sunburst、gpt-image-2.5-flare
• 官方模型：gpt-image-2-2026-04-21、gpt-image-2.5-sunburst-2026-09-08、gpt-image-2.5-flare-2026-09-08

输出与流式控制

moderation

类型："low" | "auto" | null，可选

设置 GPT Image 模型的内容审核级别。low 表示限制较少，auto 表示自动选择。

n

类型：number | null，可选

要生成的编辑后图片数量，取值范围为 1 至 10。

output_compression

类型：number | null，可选

设置 jpeg 或 webp 输出图片的压缩级别，取值范围为 0 至 100。

output_format

类型："png" | "jpeg" | "webp" | null，可选

设置输出图片格式，仅 GPT Image 模型支持。

partial_images

类型：number | null，可选

流式响应中要生成的部分图片数量，取值范围为 0 至 3。设为 0 时，响应只通过一个流式事件发送最终图片。如果完整图片生成得更快，服务端可能在达到指定的部分图片数量之前就返回最终图片。

quality

类型："low" | "medium" | "high" | "xhigh" | "max" | "auto" | null，可选

设置 GPT Image 模型的输出质量，默认值为 auto。所有 GPT Image 模型支持 low、medium 和 high；gpt-image-2.5-sunburst、gpt-image-2.5-flare 及其 2026-09-08 日期快照还支持 xhigh 和 max。

size

类型：string | "auto" | null，可选

GPT Image 模型支持标准尺寸 1024x1024、1536x1024 和 1024x1536；允许自动选择尺寸的模型还支持 auto。

gpt-image-2、gpt-image-2-2026-04-21、两种 GPT Image 2.5 模型及其 2026-09-08 日期快照支持 宽x高 格式的任意分辨率，例如 1536x864。宽和高都必须是 16 的倍数，宽高比必须在 1:3 至 3:1 之间，并且还须满足模型当前的像素数和边长限制。高于 2560x1440 的分辨率属于实验性功能，最高支持 3840x2160。

stream

类型：boolean | null，可选

是否以事件流的形式返回部分图片结果。

user

类型：string，可选

代表最终用户的唯一标识，可用于监控和检测滥用行为。

返回结果

接口返回 ImagesResponse 对象。

data 图片字段

usage 用量字段