Skip to main content
POST
OpenAI Images 兼容图像编辑

OpenAI Images 兼容图像编辑

图像编辑使用与生成相同的模型家族,但入口换成编辑路由。
  • 兼容 POST /v1/images/editsPOST /v1/edits 两个入口。
  • 同时支持 multipart/form-data 和 JSON 请求体。
  • image 为图生图,额外传 mask 为局部重绘。
  • gpt-image-1 在编辑场景下默认 quality = standardn 不传或传 0 时回退为 1

方法与路径

请求示例

响应示例

认证

Body

image
file | string | object
required
编辑输入图。multipart/form-data 下通常是文件;JSON 场景下可以是 URL、Base64 或对象结构。
prompt
string
required
编辑说明。用于描述要保留什么、修改什么。
model
string
模型名称。未传时最终是否有默认行为取决于上游,不建议省略。
mask
file | string | object
局部重绘遮罩。透明区域通常表示允许编辑的区域。
n
integer
输出数量。不传或显式传 0 时按 1 处理。
size
string
输出尺寸。具体可用值与目标模型有关。
quality
string
质量字段。gpt-image-1 在编辑表单场景下默认补成 standard
watermark
boolean
显式水印开关。显式传 false 表示明确关闭,不传表示沿用默认策略。

Response

created
integer
编辑结果生成时间戳。
data[].url
string
结果图片 URL。
data[].b64_json
string
当请求 Base64 格式时返回的图片数据。
data[].revised_prompt
string
上游可能改写后的编辑提示词。

使用场景

基础图生图

局部重绘

使用旧版别名

注意事项

编辑接口虽然同时兼容 JSON 和表单,但不同上游对字段形状的要求差异很大。最稳的做法仍然是使用 multipart/form-data 提交 imagepromptmask 这类编辑字段。

相关接口