Skip to main content
图片编辑(按张计费)

授权

Authorization
string
header
默认值:sk-your-api-key
必填

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

请求体

multipart/form-data
model
string
必填

模型调用 ID,需要支持 images_edits_v3 endpoint。

示例:

"gpt-image-2"

prompt
string
必填

图片编辑提示词,不能为空。

image
file
必填

待编辑原图文件,仅支持文件上传(multipart/form-data),可传一张或多张图片。

mask
file

可选遮罩文件,仅支持文件上传(multipart/form-data)。

n
integer
默认值:1

一次返回的图片张数,默认 1,范围 1–10。

必填范围: 1 <= x <= 10
size
enum<string>
默认值:1024x1024

输出图片尺寸,默认 1024x1024

可用选项:
auto,
1024x1024,
1024x1536,
1536x1024,
2048x2048,
2048x1152,
3840x2160,
2160x3840,
2048x1360,
1360x2048,
1152x2048,
2048x1536,
1536x2048,
2048x880,
880x2048,
688x2048,
2048x688,
2048x1024
background
enum<string>

背景模式。

可用选项:
transparent,
opaque,
auto
output_format
enum<string>

输出图片格式,默认 png

可用选项:
png,
jpeg,
webp

响应

图片编辑响应,直接返回结果图 URL 和用量统计。

created
integer

响应创建时间戳(Unix 秒)。

background
string

生成图像的背景类型。

output_format
string

输出图片格式。

quality
string

实际使用的图像质量等级,当前固定为 low

示例:

"low"

size
string

实际返回的图像尺寸。

data
object[]

图像结果列表。

usage
object