Skip to main content
POST
OpenAI图片编辑接口
此接口兼容 OpenAI Images 协议,基于输入的源图片与编辑提示词生成新图片,支持局部重绘、画面扩展与多图融合等编辑场景。

功能特性

  • 支持通过 URL 地址或文件 ID 引用待编辑的源图片
  • 支持 Inpainting 局部重绘,通过 mask 遮罩指定编辑区域
  • 支持 Outpainting 画面扩展,通过 background 提供背景图像
  • 支持 input_fidelity 控制输入图片保真度(high / low
  • 支持 pngjpegwebp 输出格式与 output_compression 压缩率控制
  • 支持 urlb64_json 两种响应格式
  • 支持流式(SSE)响应,通过 partial_images 推送中间结果

认证方式

在请求头中携带 Authorization 字段,格式为 Bearer YOUR_API_KEY

支持的图片模型

模型广场中可用的图片模型,请参考 模型列表

快速示例

编辑成功后返回图片数据:

下一步

请求头

Authorization
string
必填

API Key token (Bearer sk-xxx)

Content-Type
string

请求体

application/json
images
object[]
必填

待编辑的源图片列表

prompt
string
必填

编辑描述提示词,描述对图片的修改内容

model
string
必填

模型名称,如 "dall-e-2"

background
string

背景图像数据(用于 Outpainting 等扩展场景)

input_fidelity
string

输入图片保真度控制,取值 high, low

mask
object

遮罩图片,用于指定编辑区域(Inpainting)

n
integer

生成图片数量

output_compression
integer

输出压缩率

output_format
string

输出图片格式,如 "png"、"jpeg"、"webp"

partial_images
integer

流式返回时每次推送的中间结果图片数量

response_format
string

响应格式,"url" 或 "b64_json"

quality
string

图片质量,如 "standard"、"hd"

size
string

生成图片尺寸,如 "1024x1024"

stream
boolean

是否使用流式响应(SSE)

user
string

终端用户标识,用于监控和滥用检测

响应

200 - application/json
created
integer<int64>

图片生成时间戳(Unix 秒级时间戳)

output_format
string

输出图片格式回显

background
string

背景图像数据回显

quality
string

图片质量回显

size
string

生成图片尺寸回显

data
object[]

生成的图片数据列表

usage
object

Token 及图片用量统计