Skip to content

编辑图像(Edits)

  • 接口POST https://api.olddog.shop/v1/images/edits
  • Content-Typemultipart/form-data

对输入图像进行编辑(例如局部重绘/替换背景/添加元素)。兼容 OpenAI Images Edits 的表单上传方式。

请求参数

参数名类型是否必填说明
imagefile原始图像文件(PNG/JPG 等,以服务端支持为准)。
maskfile遮罩图(通常 PNG)。遮罩透明区域表示可被编辑区域。
promptstring编辑提示词。
modelstring图像模型 ID(如支持)。
ninteger生成数量,默认 1。
sizestring尺寸,如 1024x1024
response_formatstringurlb64_json,默认 url
userstring终端用户标识。

cURL 示例(带遮罩)

bash
curl --request POST "https://api.olddog.shop/v1/images/edits" \
  --header "Authorization: Bearer $OLD_DOG_API_KEY" \
  --form "image=@./input.png" \
  --form "mask=@./mask.png" \
  --form "prompt=把天空替换成晚霞,并在右上角添加一只风筝" \
  --form "size=1024x1024"