智能消除

更新时间:
复制 MD 格式

图像智能消除产品专为电商图片定制,自动识别并消除电商图片中的文字、特定名称、透明字块和牛皮癣,可按需指定消除图片内对象,实现大批量图片的高效、精确处理,简化图片编辑工作。(同步调用)

适用场景

  • 电商图片高效处理:清除无关的视觉元素,提供更清晰、专注的商品展示,增强顾客的购物体验。

  • 多平台商品信息同步:商家在不同电商平台同步上架商品时,可快速消除特定的文字及牛皮癣,符合不同平台的图片规范。

  • 营销素材准备:商家可轻松去除原有的促销信息,快速更新为最新的活动信息。

  • 图层信息(编辑器协议):开启 UseImageEditor 后,响应额外返回文字的位置、字体、颜色等布局信息,可用于二次编辑。完整字段说明见图片翻译编辑器协议。

商家或平台可以批量移除图片中的杂质以优化图片质量。建议与智能元素识别结合使用:先筛选出含有文字、特定名称、透明字块和牛皮癣的图片,然后使用本"智能消除"接口进行批量移除。同时在非全部消除的场景下(比如:指定文字),产品也支持用户批量输入多个指定文字进行消除。

智能元素识别专注于"识别",智能消除专注于"消除”,按顺序调用可最大限度地提高消除效果,减少“误移除”和“误识别”。如果两步都要做并希望统一编排,可直接使用智能出图。

支持消除的元素

枚举值

含义

典型示例

1

透明字块

单色透明文字、半透明色块,通常为水印

2

特定名称

品牌名、店铺名、自定义关键词

3

文字

中英文横 / 竖 / 斜排文字

4

牛皮癣

促销文案、夸张装饰元素、虚假认证标(含色字块)

服务端区分两类区域:图片主体(核心产品区域)与图片非主体(除主体外的背景)。ObjectRemoveElements 控制主体上的消除范围,NonObjectRemoveElements 控制非主体上的消除范围,两者可独立指定。

此外,支持通过 UserText / UserImage 精确指定要消除的文字或图片元素,或通过 Mask / Position 手动框定消除区域,满足更精细的消除需求。

功能介绍

  1. 首先,先明确图片主体和图片背景的定义。实际使用时,在指定消除对象时,可选择消除范围是图片主体或图片背景区域;支持API及编辑器两种接入方式,满足不同类型的需求。

    1. 图片主体:图片中的核心产品区域

    2. 图片背景:除产品主体之外的图像其余部分

  2. 其次,消除对象支持以下三种情况:

    1. 用户仅选定类型,支持选择文字、特定名称、透明字块和牛皮癣,可通过以下示例来明确使用需求,进行针对性操作

    2. (升级)提供指定图片消除,用户可一次指定多个图片

    3. (升级)提供指定文字消除,用户可一次指定多个文字

处理流程:用户传入原图URL → OCR+VLM模型检测文字或者图片位置 → 确定需要修复的区域坐标 → AI修复生成干净图片 → 返回结果图URL

效果对比

文字

区域

原图

消除后的图片

涉及到图片主体区域

image

image

不涉及到图片主体区域

image

image

特定名称

区域

原图

消除后的图片

涉及到图片主体区域

image

image

不涉及到图片主体区域

image

image

透明字块

区域

原图

消除后的图片

涉及到图片主体区域

image

image

不涉及到图片主体区域

image

image

牛皮癣

区域

原图

消除后的图片

涉及到图片主体区域

image

image

不涉及到图片主体区域

image

image

指定对象

区域

原图

消除后的图片

指定图像元素消除(支持多图像链接)

image

image

指定文本消除(支持多文字)

image

image

接口

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"])

请求参数

参数

类型

必填

说明

ImageUrl

String

是

原图 URL,图像需是JPG、JPEG、PNG、BMP、WEBP格式的,分辨率应在256×256至3000x3000像素之间,文件大小不超过10MB

示例值:"https://ae01.alicdn.com/kf/S342f0070dc9f4be09a6cbed34e90dc8fs.jpg"

ObjectRemoveElements

Number[]

否

去除图片主体上的元素(1=透明字块;2=特定名称;3=文字;4=牛皮癣),元素类型可多选。非必填,但是ObjectRemoveElements、NonObjectRemoveElements、Mask、Position、UserText、UserImage几个元素需要至少填写一个。

当多个参数均填写时生效优先级:UserImage>UserText>Position>Mask>ObjectRemoveElements=NonObjectRemoveElements

各类型说明可见产品说明

图片主体:图片中的核心产品区域。

示例值:"[1,2,4]"

NonObjectRemoveElements

Number[]

否

去除图片非主体上的元素(1=透明字块;2=特定名称;3=文字;4=牛皮癣),元素类型可多选。非必填,但是ObjectRemoveElements、NonObjectRemoveElements、Mask、Position、UserText、UserImage几个元素需要至少填写一个。

当多个参数均填写时生效优先级:UserImage>UserText>Position>Mask>ObjectRemoveElements=NonObjectRemoveElements

各类型说明可见产品说明

示例值:"[1,2,4]"

Mask

String

否

具体的消除区域。需要配合编辑器使用,入参格式为 RLE。

若传入将优先使用,忽略remove_non_product_area_elements和

remove_product_area_elements这两个参数。非必填,但是ObjectRemoveElements、NonObjectRemoveElements、Mask、Position、UserText、UserImage几个元素需要至少填写一个。

当多个参数均填写时生效优先级:UserImage>UserText>Position>Mask>ObjectRemoveElements=NonObjectRemoveElements

示例值:"474556 160 475356 160 476156 160 476956 160 477756 160 478556 160 479356 160 480156 160 480956 160 481756 160 482556 160 483356 160 484156 160 484956 160 485756 160 486556 160 487356 160 488156 160 488956 160 489756 160 490556 160 491356 160 492156 160"

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[]

否

用户指定的要消除的图片元素链接,支持多个图片链接输入,入参格式为["https://ae01.alicdn.com/kf/S342f0070dc9f4be09a6cbed34e90dc8fs.jpg","https://ae01.alicdn.com/kf/S342f0070dc9f4be09a6cbed34e90dc8fs.jpg"],非必填,但是ObjectRemoveElements、NonObjectRemoveElements、Mask、Position、UserText、UserImage几个元素需要至少填写一个

当多个参数均填写时生效优先级:UserImage>UserText>Position>Mask>ObjectRemoveElements=NonObjectRemoveElements

RLE 编码格式为"起始像素 长度"对的空格分隔串,遵循 COCO mask 约定。坐标系以图片左上角为原点。

响应字段

字段

类型

说明

Code

String

业务状态码。成功为 Success。

RequestId

String

请求唯一标识。

Message

String

信息。成功时为 "Success"。

Success

Boolean

本次调用是否成功。

Data

Object

返回的结果结构体信息。

Data.ImageUrl

String

消除处理后的结果图片 URL(OSS 签名链接)。

Data.Width

Number

输出图像宽度(像素),与原图一致。

Data.Height

Number

输出图像高度(像素),与原图一致。

Data.UsageMap

Object

用量字段。

Data.UsageMap.ProcessedImageCount

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 传入要消除的文字(支持多个),系统会自动定位并消除对应内容,无需再框选区域。

错误码

错误码

触发场景

InvalidParameter

图片格式 / 分辨率 / 大小不在范围;ObjectRemoveElements 与 NonObjectRemoveElements 同时为空且未传 Mask;Mask 不是合法 RLE 编码。

InputContentBlocked

输入图片触发内容安全审核。

DownstreamUnavailable

图片下载失败 / 下游视觉模型暂时不可用。建议指数退避后重试。

FreeQuotaExhausted

试用额度已耗尽,需购买商品包或关闭"用完即停"。

InternalError

服务端内部错误。请保留 RequestId 联系技术支持。

完整错误码列表参见错误码。

使用限制

  • 调用模式:同步。默认 QPS = 5,单次请求超时上限 30 秒。

  • 输入图片:JPG / JPEG / PNG / BMP / WEBP;分辨率 256×256 至 3000×3000;文件 ≤ 10 MB。

  • Mask 模式:传入 Mask 时,主体 / 非主体的枚举消除参数将被忽略。三者不可全部为空。

  • 计费:¥0.025/张,按 ProcessedImageCount 计件。详见素材优化计费。

常见问题

物体被文字遮挡时,消除文字后是否支持生成全新的被遮挡区域?

目前只支持消除区域并进行简单的颜色修复,暂不支持复杂物体区域的生成。

如果自动消除效果不理想,是否可以手动调整?

可通过编辑器接入方式手动调整,在编辑器内手动涂抹 / 框选 / 圈选需要消除的选区。编辑器能力后续 Aidge 将在控制台提供,支持图片编辑器编辑。

后续步骤