图像背景移除
把人物从照片中抠出，返回去除背景的照片，用于证件照和头像。
POST
/v3/store/smart-city/remove-background试一试- 价格1 IC每次请求
- 实测0.790
- 累计调用677K次
- v2.0
- 运行中
- 基准报告 (PDF)
请求
multipart/form-data，每次一张图像。每次请求 1 IC。
请求头
apikeystring必填您的 API 密钥，在控制台的 API Keys 中创建。
请求体
filefile必填照片。JPEG 或 PNG，最大 2 MB。
rotateIfPortiatboolean本用于把竖向图像旋转为横向输出，但目前对文件上传不起作用：图像按原方向返回。字段拼写为 API 原有拼写。
旧路径 /face-extractor 与 /remove-bg 仍可 用，价格相同。
响应
移除背景后的照片。
移除背景后的照片。
详情
实测
2026 年 10 月 28 日在生产环境测得，使用公开的 COCO 2017 验证集中的 802 张照片，每张仅含一个清晰主体，轮廓由人工标注：人物 186 张、动物 143 张、交通工具 218 张、其他物体 255 张。评分采用 IoU，即抠图结果与真实主体的重叠程度，1 为完全一致。
| 指标 | 结果 |
|---|---|
| 平均 IoU，人物照片 186 张 | 0.790（95% CI 0.760–0.818）；中位数 0.857 |
| 人物占画面 10–20% / 20–30% / 30% 及以上 | 0.815 / 0.822 / 0.743 |
| 人物抠图失败（IoU 低于 0.5） | 186 张中 20 张，其中 15 张人物占画面 30% 及以上 |
| 平均 IoU，全部 802 张 | 0.733（95% CI 0.714–0.752）；中位数 0.856 |
| 动物 / 交通工具 / 其他物体 | 0.825 / 0.722 / 0.651 |
| 抠图失败，全部 802 张 | 149 张（18.6%） |
| 经 API 的中位耗时，150 张 | 0.33 秒 |
多数抠图结果贴合主体，失败时则整体失败：在昏暗或低对比度的场景中，服务可能几乎什么都不保留；深色衣服配深色背景时，可能只保留脸部；人物把蛋糕、电话等物体举到镜头前时，服务可能只抠出该物体而丢掉人物。近景得分低于中景人物，因此请在人物周围留出空间，不要让人物占满画面。测试照片为长边不超过 640 像素的普通照片，轮廓为人工绘制，并非纯色背景的影棚人像，因此证件照场景以及头发等细节边缘未单独测量。方法与限制：基准测试报告 (PDF)。
限制
- 为仅含一个清晰主体（例如人物）的照片设计。近景的抠图效果不如中景人物，见实测。
数据处理
图像在内存中处理，响应返回后不保留。依 PDPA 与 GDPR 取得同意并告知当事人，由作为数据控制者的您负责。