POST
图片编辑兼容别名

Authorizations

Authorization
string
header
required

在请求头中传入:Authorization: Bearer sk-...

Body

multipart/form-data

不推荐新接入使用。OpenAI Images Edits 兼容的 multipart 图片编辑请求,仅保留给必须使用 multipart 编辑语义的旧客户端。参考图创作、换装、合成或改图统一推荐使用 /v1/images/generations/jobs 的 JSON image 数组创建异步任务。gpt-image-2-2K 和 gpt-image-2-4K 不支持本接口。

model
string
required

图片编辑模型 ID,例如 qwen-image 或兼容编辑模型。

image
required

要编辑的图片 URL。使用 OSS/CDN 等公网可访问地址时,确保 URL 未过期且模型可读取。多图网络 URL 场景推荐改用 /v1/images/generations/jobs 的 JSON image 数组。

prompt
string
required

编辑指令。说明要保留什么、修改什么、输出风格和限制条件。

mask
file

遮罩图。透明区域表示允许修改的位置;常见要求为 PNG 格式,并与原图尺寸一致。

size
string

输出尺寸。可选值以模型说明为准;不确定尺寸时使用 auto 或模型页列出的尺寸。

Example:

"1024x1024"

Response

图片结果

created
integer
data
object[]
usage
object