编辑图像(Edits)
- 接口:
POST https://api.olddog.shop/v1/images/edits - Content-Type:
multipart/form-data
对输入图像进行编辑(例如局部重绘/替换背景/添加元素)。兼容 OpenAI Images Edits 的表单上传方式。
请求参数
| 参数名 | 类型 | 是否必填 | 说明 |
|---|---|---|---|
| image | file | 是 | 原始图像文件(PNG/JPG 等,以服务端支持为准)。 |
| mask | file | 否 | 遮罩图(通常 PNG)。遮罩透明区域表示可被编辑区域。 |
| prompt | string | 是 | 编辑提示词。 |
| model | string | 否 | 图像模型 ID(如支持)。 |
| n | integer | 否 | 生成数量,默认 1。 |
| size | string | 否 | 尺寸,如 1024x1024。 |
| response_format | string | 否 | url 或 b64_json,默认 url。 |
| user | string | 否 | 终端用户标识。 |
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"