编辑图像

在给定原始图像和提示的情况下创建编辑或扩展图像,兼容 OpenAI 图像编辑接口规范。

接口信息

  • 请求方式POST
  • 请求地址/v1/images/edits

认证方式

Bearer Token

请求头:Authorization: Bearer sk-xxxxxx

请求头

参数位置说明
AuthorizationHeaderBearer ,格式:Authorization: Bearer sk-xxxxxx

请求体

Content-Type:multipart/form-data

参数名类型是否必填说明
imagefile要编辑的图像。必须是有效的 PNG 文件,小于 4MB,并且是方形的。如果未提供遮罩,图像必须具有透明度,透明区域将用作遮罩。
maskfile附加图像,完全透明区域(alpha 为零)指示图像应编辑的位置。必须是有效的 PNG 文件,小于 4MB,尺寸与原始 image 相同。
promptstring所需图像的文本描述。最大长度为 1000 个字符。
nstring要生成的图像数。取值范围:1 ~ 10。
sizestring生成图像的尺寸。可选值:256x256512x5121024x1024
response_formatstring图像返回格式,可选:urlb64_json
userstring终端用户唯一标识符,用于监控与识别滥用。
modelstring图像模型名称。

响应信息

  • HTTP 状态码:200
  • Content-Type:application/json

请求示例

curl "你的接口地址/v1/images/edits" \
  -H "Authorization: Bearer sk-xxxxxx" \
  -F "image=@source.png" \
  -F "prompt=在图片空白处增加一朵鲜花" \
  -F "n=1" \
  -F "size=1024x1024" \
  -F "response_format=b64_json"