跳转到主要内容
POST
/
v1
/
images
/
edits
编辑图片
curl --request POST \
  --url https://ai.alad.com/v1/images/edits \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: multipart/form-data' \
  --form model=gpt-image-2 \
  --form 'prompt=将图片背景替换为海上日落' \
  --form image='@example-file' \
  --form 'image[]=<string>' \
  --form mask='@example-file' \
  --form output_format=png \
  --form output_compression=50 \
  --form n=1 \
  --form size=1024x1024 \
  --form response_format=url \
  --form image[].items='@example-file'
{
  "data": [
    {
      "url": "<string>",
      "b64_json": "<string>",
      "revised_prompt": "<string>"
    }
  ]
}

授权

Authorization
string
header
必填

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

请求体

multipart/form-data
model
enum<string>
必填

模型 ID。gpt-image-2 为官方模型,gpt-image-2-c 为高性价比版本(支持 response_format)。

可用选项:
gpt-image-2,
gpt-image-2-c
示例:

"gpt-image-2"

prompt
string
必填

编辑指令文本。

示例:

"将图片背景替换为海上日落"

image
file

单张源图片文件(PNG 或 JPEG)。多图时请改用 image[]

image[]
file[]

多张源图片文件(PNG 或 JPEG),每次请求最多 16 张。多图时用此参数替代 image

mask
file

蒙版图片文件(含 Alpha 通道),用于指定源图片中要编辑的区域。必须与源图片格式和尺寸一致(< 50MB)。需在控制台选择 Direct 分组。

output_format
enum<string>
默认值:png

输出图片格式,默认 png

可用选项:
png,
jpeg
output_compression
integer

jpeg 格式的压缩级别(0–100)。

必填范围: 0 <= x <= 100
n
integer
默认值:1

返回图片数量,支持 1–10,默认 1需在控制台选择 Direct 分组。

必填范围: 1 <= x <= 10
示例:

1

size
string
默认值:1024x1024

输出图片尺寸,格式 {宽}x{高},约束与图片生成接口一致(灵活分辨率)。

示例:

"1024x1024"

response_format
enum<string>
默认值:url

响应格式。gpt-image-2-c(高性价比版本)支持该参数,当前仅 url

可用选项:
url
示例:

"url"

响应

图片编辑成功。

data
object[]

编辑后的图片数组。