# 通过蒙版去背景接口（openai-cv-service-smzdm-com/）
# 基本信息
Path： /pictures/remove_img_by_mask
Method： POST
接口描述： 通过蒙版去背景接口可以根据提供的蒙版或边界框信息来移除图片中的特定区域，例如水印、二维码等。该接口接收图片URL和蒙版URL或边界框列表作为输入，并返回处理后的图片。
用户可以通过两种方式指定要移除的区域：
- 提供蒙版图片URL（mask_url）
- 提供边界框坐标列表（box_list），这些坐标可从水印识别接口获取
水印识别接口（https://apidoc-team.smzdm.com/project/1198/interface/api/56096）可以检测图片中的水印和二维码，其中：
- class_id = 0 表示水印
- class_id = 1 表示二维码
上传配置示例：
"upload_img_config": {"channel": 1202, "type": "aigc-image", "oper": "aigc"}
1
请求示例：
{
"img_url": "https://qn-image-aigc.zdmimg.com/202408/12/66b9dd780a5ee7489.jpg",
"box_list": [
[
[1146.0186767578125, 1582.157958984375],
[1146.0186767578125, 1629.1865234375],
[1238.9122314453125, 1629.1865234375],
[1238.9122314453125, 1582.157958984375]
],
[
[939.1505126953125, 1645.6549072265625],
[939.1505126953125, 1673.5172119140625],
[1239.6468505859375, 1673.5172119140625],
[1239.6468505859375, 1645.6549072265625]
]
],
"from": "ai_aigc_lingmou_wangmc"
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
# 请求参数
Headers
| 参数名称 | 参数值 | 是否必须 | 示例 | 备注 |
|---|---|---|---|---|
| Content-Type | application/json | 是 |
Body
# 请求参数
Body
| 名称 | 类型 | 是否必须 | 默认值 | 备注 |
|---|---|---|---|---|
| img_url | string | 非必须 | 图片地址 | |
| mask_url | string | 非必须 | 蒙版地址和 box_list 二选一就可以了 | |
| box_list | array[] | 非必须 | 水印坐标，来自 /pictures/detection_identify 接口 | |
| upload_img_config | object | 非必须 | 上传配置 | |
| upload_img_config.channel | number | 非必须 | ||
| upload_img_config.type | string | 非必须 | ||
| upload_img_config.oper | string | 非必须 |
# 返回数据
| 名称 | 类型 | 是否必须 | 默认值 | 备注 |
|---|---|---|---|---|
| error_code | number | 非必须 | ||
| error_msg | string | 非必须 | ||
| data | object [] | 非必须 | ||
| data.img_base64 | string | 非必须 |
