图像智能消除产品专为电商图片定制,自动识别并消除电商图片中的文字、特定名称、透明字块和牛皮癣,可按需指定消除图片内对象,实现大批量图片的高效、精确处理,简化图片编辑工作。(同步调用)
适用场景
电商图片高效处理:清除无关的视觉元素,提供更清晰、专注的商品展示,增强顾客的购物体验。
多平台商品信息同步:商家在不同电商平台同步上架商品时,可快速消除特定的文字及牛皮癣,符合不同平台的图片规范。
营销素材准备:商家可轻松去除原有的促销信息,快速更新为最新的活动信息。
图层信息(编辑器协议):开启
UseImageEditor后,响应额外返回文字的位置、字体、颜色等布局信息,可用于二次编辑。完整字段说明见图片翻译编辑器协议。
商家或平台可以批量移除图片中的杂质以优化图片质量。建议与智能元素识别结合使用:先筛选出含有文字、特定名称、透明字块和牛皮癣的图片,然后使用本"智能消除"接口进行批量移除。同时在非全部消除的场景下(比如:指定文字),产品也支持用户批量输入多个指定文字进行消除。
智能元素识别专注于"识别",智能消除专注于"消除”,按顺序调用可最大限度地提高消除效果,减少“误移除”和“误识别”。如果两步都要做并希望统一编排,可直接使用智能出图。
支持消除的元素
枚举值 | 含义 | 典型示例 |
| 透明字块 | 单色透明文字、半透明色块,通常为水印 |
| 特定名称 | 品牌名、店铺名、自定义关键词 |
| 文字 | 中英文横 / 竖 / 斜排文字 |
| 牛皮癣 | 促销文案、夸张装饰元素、虚假认证标(含色字块) |
服务端区分两类区域:图片主体(核心产品区域)与图片非主体(除主体外的背景)。ObjectRemoveElements 控制主体上的消除范围,NonObjectRemoveElements 控制非主体上的消除范围,两者可独立指定。
此外,支持通过 UserText / UserImage 精确指定要消除的文字或图片元素,或通过 Mask / Position 手动框定消除区域,满足更精细的消除需求。
功能介绍
首先,先明确图片主体和图片背景的定义。实际使用时,在指定消除对象时,可选择消除范围是图片主体或图片背景区域;支持API及编辑器两种接入方式,满足不同类型的需求。
图片主体:图片中的核心产品区域
图片背景:除产品主体之外的图像其余部分
其次,消除对象支持以下三种情况:
用户仅选定类型,支持选择文字、特定名称、透明字块和牛皮癣,可通过以下示例来明确使用需求,进行针对性操作
(升级)提供指定图片消除,用户可一次指定多个图片
(升级)提供指定文字消除,用户可一次指定多个文字
处理流程:用户传入原图URL → OCR+VLM模型检测文字或者图片位置 → 确定需要修复的区域坐标 → AI修复生成干净图片 → 返回结果图URL
效果对比
文字
区域 | 原图 | 消除后的图片 |
涉及到图片主体区域 |
|
|
不涉及到图片主体区域 |
|
|
特定名称
区域 | 原图 | 消除后的图片 |
涉及到图片主体区域 |
|
|
不涉及到图片主体区域 |
|
|
透明字块
区域 | 原图 | 消除后的图片 |
涉及到图片主体区域 |
|
|
不涉及到图片主体区域 |
|
|
牛皮癣
区域 | 原图 | 消除后的图片 |
涉及到图片主体区域 |
|
|
不涉及到图片主体区域 |
|
|
指定对象
区域 | 原图 | 消除后的图片 |
指定图像元素消除(支持多图像链接) |
|
|
指定文本消除(支持多文字) |
|
|
接口
POST /rest/ai/image/remove快速开始
import json
# 仅消除非主体区域上的透明字块、特定名称、牛皮癣
data = json.dumps({
"ImageUrl": "https://example.com/product-with-watermark.jpg",
"NonObjectRemoveElements": [1, 2, 4]
})
result = make_signed_request("/rest/ai/image/remove", data)
d = result["Data"]
print("消除后图片:", d["ImageUrl"])
print("输出尺寸:", d["Width"], "x", d["Height"])完整的请求签名说明,以及 Java / Python / Go 等多语言 SDK 调用示例与在线调试,详见阿里云 OpenAPI 开发者门户:智能消除 API(OpenAPI 门户)。
请求参数
参数 | 类型 | 必填 | 说明 |
ImageUrl | String | 是 | 原图 URL,图像需是JPG、JPEG、PNG、BMP、WEBP格式的,分辨率应在256×256至3000x3000像素之间,文件大小不超过10MB 示例值: |
ObjectRemoveElements | Number[] | 否 | 去除图片主体上的元素(1=透明字块;2=特定名称;3=文字;4=牛皮癣),元素类型可多选。非必填,但是ObjectRemoveElements、NonObjectRemoveElements、Mask、Position、UserText、UserImage几个元素需要至少填写一个。 当多个参数均填写时生效优先级:UserImage>UserText>Position>Mask>ObjectRemoveElements=NonObjectRemoveElements 各类型说明可见产品说明 图片主体:图片中的核心产品区域。 示例值: |
NonObjectRemoveElements | Number[] | 否 | 去除图片非主体上的元素(1=透明字块;2=特定名称;3=文字;4=牛皮癣),元素类型可多选。非必填,但是ObjectRemoveElements、NonObjectRemoveElements、Mask、Position、UserText、UserImage几个元素需要至少填写一个。 当多个参数均填写时生效优先级:UserImage>UserText>Position>Mask>ObjectRemoveElements=NonObjectRemoveElements 各类型说明可见产品说明 示例值: |
Mask | String | 否 | 具体的消除区域。需要配合编辑器使用,入参格式为 RLE。 若传入将优先使用,忽略remove_non_product_area_elements和 remove_product_area_elements这两个参数。非必填,但是ObjectRemoveElements、NonObjectRemoveElements、Mask、Position、UserText、UserImage几个元素需要至少填写一个。 当多个参数均填写时生效优先级:UserImage>UserText>Position>Mask>ObjectRemoveElements=NonObjectRemoveElements 示例值: |
Position | String | 否 | 具体的消除区域。需要配合编辑器使用,入参格式为 四点坐标[xx,yy,zz,dd]。非必填,但是ObjectRemoveElements、NonObjectRemoveElements、Mask、Position、UserText、UserImage几个元素需要至少填写一个 当多个参数均填写时生效优先级:UserImage>UserText>Position>Mask>ObjectRemoveElements=NonObjectRemoveElements |
UserText | String[] | 否 | 用户指定的文本,支持多个文本输入,入参格式为["xx","yy"],非必填,但是ObjectRemoveElements、NonObjectRemoveElements、Mask、Position、UserText、UserImage几个元素需要至少填写一个 当多个参数均填写时生效优先级:UserImage>UserText>Position>Mask>ObjectRemoveElements=NonObjectRemoveElements |
UserImage | String[] | 否 | 用户指定的要消除的图片元素链接,支持多个图片链接输入,入参格式为[" 当多个参数均填写时生效优先级:UserImage>UserText>Position>Mask>ObjectRemoveElements=NonObjectRemoveElements |
RLE 编码格式为"起始像素 长度"对的空格分隔串,遵循 COCO mask 约定。坐标系以图片左上角为原点。
响应字段
字段 | 类型 | 说明 |
| String | 业务状态码。成功为 |
| String | 请求唯一标识。 |
| String | 信息。成功时为 |
| Boolean | 本次调用是否成功。 |
| Object | 返回的结果结构体信息。 |
| String | 消除处理后的结果图片 URL(OSS 签名链接)。 |
| Number | 输出图像宽度(像素),与原图一致。 |
| Number | 输出图像高度(像素),与原图一致。 |
| Object | 用量字段。 |
| Number | 本次已处理图片张数,用于计费核对。 |
完整示例
请求示例
{
"ImageUrl": "https://aib-innovation-oss.oss-accelerate.aliyuncs.com/AI_Business/asTYo/removaltest2.png?Expires=3356502130&OSSAccessKeyId=LTAI*****",
"NonObjectRemoveElements": null,
"ObjectRemoveElements": [
1,
2,
4
],
"Mask": null,
"UserText": [
"科技",
"秘密武器"
],
"UserImage": [
"xxxxxxxxx",
"xxxxxxxxx"
]
}响应示例
{
"Data": {
"ImageUrl": "http://dashscope-7c2c.oss-cn-shanghai.aliyuncs.com/7d/25/20260813/909f6051/feb09c19-e7f7-4b64-856d-0c83cac288b0.jpg?Expires=1789198273&OSSAccessKeyId=LTAI*****",
"Height": 896,
"UsageMap": {
"ProcessedImageCount": 1
},
"Width": 692
},
"RequestId": "019FFA08-2261-19C1-A546-0137FD063D3B",
"Message": "Success",
"Code": "success",
"Success": true
}使用建议
仅消除非主体区域:电商主图通常只需要去掉背景的促销文字,保留主体上的产品标签。这种场景只传
NonObjectRemoveElements即可。主体上有大面积文字:如 T 恤胸前的品牌 logo。直接消除可能影响主体完整度,建议先用智能元素识别评估,再决定是否消除。
精确消除指定区域:当自动识别无法精确覆盖目标(如形状不规则的水印)时,可通过 API 传入 Mask 参数指定要消除的区域。
消除指定图像元素或文字: 当明确知道要消除的对象时,可通过 UserImage 传入要消除的图片元素链接(支持多个),或通过 UserText 传入要消除的文字(支持多个),系统会自动定位并消除对应内容,无需再框选区域。
错误码
错误码 | 触发场景 |
| 图片格式 / 分辨率 / 大小不在范围; |
| 输入图片触发内容安全审核。 |
| 图片下载失败 / 下游视觉模型暂时不可用。建议指数退避后重试。 |
| 试用额度已耗尽,需购买商品包或关闭"用完即停"。 |
| 服务端内部错误。请保留 |
完整错误码列表参见错误码。
使用限制
调用模式:同步。默认 QPS = 5,单次请求超时上限 30 秒。
输入图片:JPG / JPEG / PNG / BMP / WEBP;分辨率 256×256 至 3000×3000;文件 ≤ 10 MB。
Mask 模式:传入
Mask时,主体 / 非主体的枚举消除参数将被忽略。三者不可全部为空。计费:¥0.025/张,按
ProcessedImageCount计件。详见素材优化计费。



















