Skip to main content
POST
编辑图片

授权

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[]

编辑后的图片数组。