Skip to main content
POST
编辑图片

授权

Authorization
string
header
必填

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

请求体

model
enum<string>
必填

图像模型。两个模型名等价,任选其一。

可用选项:
gpt-image-2.5-flare,
gpt-image-2.5-sunburst
示例:

"gpt-image-2.5-flare"

prompt
string
必填

期望的修改描述。

示例:

"把狐狸的毛变成亮蓝色,并加上飘落的雪花"

images
object[]
必填

要编辑的源图。用这个 JSON 形式可以传 URL,而不必上传文件。

Required array length: 1 - 16 elements
mask
object

可编辑区域。须为带 alpha 通道、且与源图同尺寸的 PNG。

n
integer
默认值:1

生成图片数量。

必填范围: 1 <= x <= 10
size
string

{width}x{height} 格式。边长须为 16 的倍数,宽高比 ≤ 3:1,总像素 655,360–8,294,400,最长边 3,840px。不传则由模型自行选择(约 130 万像素)。

示例:

"1024x1024"

quality
enum<string>
默认值:low

渲染质量。

可用选项:
low,
medium,
high,
auto
background
enum<string>
默认值:opaque

背景处理方式。

可用选项:
opaque,
transparent,
auto
output_format
enum<string>
默认值:png

输出图片格式。

可用选项:
png,
jpeg
output_compression
integer

jpeg 输出的压缩级别。

必填范围: 0 <= x <= 100
moderation
enum<string>
默认值:auto

内容审核严格程度。

可用选项:
auto,
low
stream
boolean
默认值:false

是否以 SSE 推送中间帧。

partial_images
integer

stream 为 true 时请求的预览帧数量。

响应

图片编辑成功

created
integer

生成时间的 Unix 时间戳。

background
string

实际使用的背景处理方式。

output_format
string

返回图片的格式。

quality
string

实际使用的质量档位。

size
string

实际使用的分辨率。

data
object[]
usage
object