跳到主要内容

Ophrah gpt-image-2 图片编辑

POST 
/v1/images/edits

基于一张或多张输入图片，按提示词进行编辑、改图或多图合成。

  • 请求路径：POST /v1/images/edits
  • 请求格式：multipart/form-data
  • 单图编辑：传 image 字段
  • 多图合成：传多个 image[] 字段（最多 16 张）
  • 局部编辑：可选传 mask，白色区域会被修改，黑色区域保持不变
  • gpt-image-2 不支持 input_fidelity 参数

单图编辑示例：

API_BASE_URL="<YOUR_API_BASE_URL>"

curl --location "${API_BASE_URL}/v1/images/edits" \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --form 'model="gpt-image-2"' \
  --form 'prompt="Change the background to a rainy night scene, keep the subject unchanged"' \
  --form 'image=@"/path/to/source.png"' \
  --form 'quality="high"' \
  --form 'size="1024x1024"'

多图合成示例：

API_BASE_URL="<YOUR_API_BASE_URL>"

curl --location "${API_BASE_URL}/v1/images/edits" \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --form 'model="gpt-image-2"' \
  --form 'prompt="Create a gift basket containing all the items from the reference images"' \
  --form 'image[]=@"/path/to/item-1.png"' \
  --form 'image[]=@"/path/to/item-2.png"' \
  --form 'image[]=@"/path/to/item-3.png"' \
  --form 'quality="medium"'

Request​

Responses​

图片编辑成功