图像编辑（OpenAI 原生格式）

上传原始图像和可选遮罩，根据提示词生成编辑或扩展后的图像。接口使用 multipart/form-data，与图像生成的 JSON 请求不同。

请求

POST /v1/images/edits
Authorization: Bearer sk-your-api-key
Content-Type: multipart/form-data

调用示例

curl -X POST "https://www.walmind.cn/v1/images/edits" \
  -H "Authorization: Bearer $API_KEY" \
  -F "image=@original.png" \
  -F "mask=@mask.png" \
  -F "prompt=把背景改成海边日落" \
  -F "model=your-image-model" \
  -F "n=1" \
  -F "size=1024x1024" \
  -F "response_format=url"

请求参数

参数	类型	说明
image	file	原始图像，必填；具体格式、大小和尺寸限制以模型为准
mask	file	可选遮罩，透明区域表示需要编辑的位置
prompt	string	编辑目标的文字描述，必填
model	string	图像模型 ID，可选或必填取决于部署
n	integer	生成数量，通常为 1 至 10
size	string	输出尺寸，例如 256x256、512x512 或 1024x1024
response_format	string	url 或 b64_json

响应示例

{
  "created": 1710000000,
  "data": [{"url": "https://example.com/edited-image.png"}]
}

上传前请检查图像格式、文件大小和遮罩尺寸。部分模型要求 PNG、正方形图像或透明通道，不能把这些限制假定为所有渠道的通用规则。