Skip to main content
POST
/
v1
/
images
/
edits
GPT-Image 图像编辑
curl --request POST \
  --url https://api.example.com/v1/images/edits \
  --header 'Content-Type: application/json' \
  --data '
{
  "image": {},
  "prompt": "<string>",
  "model": "<string>",
  "mask": {},
  "n": 123,
  "size": "<string>",
  "quality": "<string>",
  "watermark": true
}
'
{
  "created": 1735689600,
  "data": [
    {
      "url": "https://cdn.example.com/images/edit-abc123.png",
      "revised_prompt": "把背景改成科技感办公室，保留主体构图"
    }
  ]
}

Documentation Index

Fetch the complete documentation index at: https://mercury-eab3b728.mintlify.app/llms.txt

Use this file to discover all available pages before exploring further.

​
GPT-Image 图像编辑

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

​
方法与路径

MethodPath
POST/v1/images/edits
POST/v1/edits

​
请求示例

curl -X POST https://www.geeknow.top/v1/images/edits \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "model=gpt-image-1" \
  -F "prompt=把背景改成科技感办公室，保留主体构图" \
  -F "image=@input.png" \
  -F "size=1024x1024" \
  -F "watermark=false"

​
响应示例

{
  "created": 1735689600,
  "data": [
    {
      "url": "https://cdn.example.com/images/edit-abc123.png",
      "revised_prompt": "把背景改成科技感办公室，保留主体构图"
    }
  ]
}

​
认证

Authorization: Bearer YOUR_API_KEY

​
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
上游可能改写后的编辑提示词。

​
使用场景

​
基础图生图

curl -X POST https://www.geeknow.top/v1/images/edits \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "model=gpt-image-1" \
  -F "prompt=把人物服装改成深蓝色西装" \
  -F "image=@portrait.png"

​
局部重绘

curl -X POST https://www.geeknow.top/v1/images/edits \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "model=gpt-image-1" \
  -F "prompt=把背景改成现代办公室" \
  -F "image=@input.png" \
  -F "mask=@mask.png"

​
使用旧版别名

curl -X POST https://www.geeknow.top/v1/edits \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "model=gpt-image-1" \
  -F "prompt=保留主体，增强灯光层次" \
  -F "image=@input.png"

​
注意事项

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

​
相关接口