Skip to main content
POST
编辑图像

Authorizations

Authorization
string
header
required

API Key 通过 Authorization: Bearer <key> 传入。

Body

multipart/form-data

multipart/form-data 请求体。

image
file
required

待编辑的输入图像(png/jpeg/webp)。多张输入请改用重复的 image[] 字段。

prompt
string
required

描述所需编辑的指令。

Maximum string length: 32000
image[]
file[]

多张输入图像(重复表单字段,最多 16 张)。

mask
file

可选 PNG 蒙版;完全透明(alpha=0)区域为待编辑区域。

model
enum<string>
default:gpt-image-2-official
Available options:
gpt-image-2-official
input_fidelity
enum<string>

对原始输入图像的保真程度。

Available options:
high,
low
n
integer
default:1

生成的编辑图数量。

Required range: 1 <= x <= 10
size
string
default:auto

输出尺寸(规则同生成接口)。

Examples:

"auto"

"1024x1024"

"1536x1024"

"1024x1536"

quality
enum<string>
default:auto
Available options:
low,
medium,
high,
auto
background
enum<string>
default:auto

背景处理。暂不支持透明背景。

Available options:
opaque,
auto
output_format
enum<string>
default:png

输出图像格式。

Available options:
png,
jpeg
output_compression
integer
default:100

jpeg 输出的压缩级别。

Required range: 0 <= x <= 100
moderation
enum<string>
default:auto
Available options:
low,
auto
user
string

用于滥用监测的终端用户标识。

Response

编辑后的图像。

created
integer
required

Unix 时间戳(秒)。

data
object[]
required
background
enum<string>
Available options:
opaque
output_format
enum<string>
Available options:
png,
jpeg
quality
enum<string>
Available options:
low,
medium,
high
size
string

实际渲染尺寸,如 1024x1024

usage
object