图像编辑 (Images Edits)

图像编辑接口用于在提供原始图像以及遮罩（Mask）的基础上，根据提示词（Prompt）对图像指定区域进行编辑、填充或替换。该接口采用 multipart/form-data 数据类型上传图片文件。

接口端点

POST /v1/images/edits

请求参数

参数	类型	必填	默认值	说明
image	file	✅	-	原始图片文件。必须是 PNG 格式，大小不超过 4MB，且必须是正方形。
mask	file	❌	-	遮罩图片文件。用于指示哪些区域应当被修改，要求同 image，透明区域表示需要替换修改的地方。
prompt	string	✅	-	描述如何编辑图像的提示词。
model	string	❌	dall-e-2	调用的绘图编辑模型 ID（通常为 dall-e-2）。
n	integer	❌	1	生成的图像数量。
size	string	❌	1024x1024	图像分辨率（必须是正方形，如 1024x1024, 512x512）。
response_format	string	❌	url	返回格式。支持 url 或 b64_json。

调用示例

cURL 请求

curl https://api.easytakeai.com/v1/images/edits \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F image="@original.png" \
  -F mask="@mask.png" \
  -F prompt="在草地上添加一只晒太阳的小花猫" \
  -F size="1024x1024"

JSON 响应示例

{
  "created": 1716298530,
  "data": [
    {
      "url": "https://api.easytakeai.com/assets/images/edited-img-67890.png"
    }
  ]
}