Skip to content

局部重绘(Inpainting) ​

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

在编辑器中试用:消除。

基本信息 ​

项目值
接口路径POST /image/inpainting
所需 Scopeinpainting 或 *
任务类型异步,返回 taskId

请求参数 ​

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

参数说明 ​

参数类型必填默认值说明
requestIdstring否服务端生成调用方请求 ID。省略时服务端生成,并在响应里返回
urlstring是—原始图像的公开 HTTPS URL
maskUrlstring是—遮罩图的公开 HTTPS URL(见下方格式要求)

遮罩图格式要求 ​

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

本地的原图或遮罩先 POST /images/upload,把返回的 data.url 填进 url 或 maskUrl。


请求示例 ​

bash
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"

响应示例 ​

提交成功:

json
{
  "code": 0,
  "msg": "",
  "data": {
    "requestId": "3f1c2a7e-4b9d-4e11-9c2a-6d0e8f1a2b33",
    "taskId": "img-inpaint321zy"
  }
}

获取结果 ​

任务成功(status: 1)后,resultType 为 image,imageUrls 包含重绘后的完整图像(白色遮罩区域已替换,其余区域与原图一致)。

任务失败(status: 2)时,原因在 resultMetadata。

详见异步任务文档。


常见问题 ​

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

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

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

妙图设计 API Beta