局部重绘（Inpainting）

根据遮罩图，对图像的指定区域进行重新生成（修复、替换或填充）。

基本信息

项目	值
接口路径	POST /image/inpainting
所需 Scope	inpainting 或 *

| 任务类型 | 异步，返回 taskId |

---

请求参数

{
  "requestId": "可选，调用方自定义唯一 ID",
  "url": "原始图像的公开 HTTPS URL（必填）",
  "maskUrl": "遮罩图的公开 HTTPS URL（必填）"
}

参数说明

参数	类型	必填	默认值	说明
requestId	string	否	null	调用方请求 ID
url	string	是	—	原始图像的公开 HTTPS URL
maskUrl	string	是	—	遮罩图的公开 HTTPS URL（见下方格式要求）

遮罩图格式要求

• 格式：PNG（支持灰度或黑白图）。
• 白色区域：将被重新生成（需要修复/替换的部分）。
• 黑色区域：保持原图不变。
• 遮罩图尺寸应与原始图像相同。

---

请求示例

curl -s -X POST \
  -H "Authorization: Bearer $TUSEN_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://example.com/original-image.jpg",
    "maskUrl": "https://example.com/inpaint-mask.png"
  }' \
  "https://magiqsight.com/openapi/v1/image/inpainting"

---

响应示例

提交成功：

{
  "code": 0,
  "msg": null,
  "data": {
    "requestId": null,
    "taskId": "img-inpaint321zy"
  }
}

---

获取结果

任务成功（status: 1）后，imageUrls 包含重绘后的完整图像（白色遮罩区域已替换，其余区域与原图一致）。

详见异步任务文档。

---

常见问题

Q：遮罩图必须和原图同尺寸吗？
A：建议保持相同尺寸，以确保遮罩区域精确对应原图像素位置。

Q：重绘区域内容由什么决定？
A：当前版本根据图像上下文自动推断重绘内容。

Q：如何移除图像中的水印或物体？
A：将需要移除的区域绘制为白色遮罩，模型会根据周围背景填充该区域。