AI 助理
文档备案控制台
官方文档
首页

智能消除

更新时间：
复制 MD 格式
我的收藏

专为电商图片定制的智能消除能力，自动识别并消除文字、特定名称、透明字块、牛皮癣四类元素；可按主体 / 非主体分别指定消除范围，也支持通过 Mask（RLE 编码）精确指定消除区域，适合大批量图片的高效净化。同步调用。

适用场景

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

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

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

商家或平台可以批量移除图片中的杂质以优化图片质量。建议与智能元素识别 API结合使用：先筛选出含有文字、特定名称、透明字块和牛皮癣的图片，然后使用本"智能消除"接口进行批量移除。智能元素识别专注于"识别"，智能消除专注于"消除"，按顺序调用可最大限度地提高消除效果，减少"误移除"和"误识别"。如果两步都要做并希望统一编排，可直接使用智能出图。

支持消除的元素

枚举值

含义

典型示例

1

透明字块

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

2

特定名称

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

3

文字

中英文横 / 竖 / 斜排文字

4

牛皮癣

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

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

功能介绍

消除前先明确两个区域：

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

  • 图片背景：除产品主体之外的其余部分。

指定消除对象时，可分别在主体或背景区域生效；支持 API 与编辑器两种接入方式。消除对象支持文字 / 特定名称 / 透明字块 / 牛皮癣四类，详见下方"效果对比"示例。

效果对比

文字

区域

原图

消除后的图片

涉及到图片主体区域

image.png

image.png

不涉及到图片主体区域

image.png

image.png

特定名称

区域

原图

消除后的图片

涉及到图片主体区域

image.png

image.png

不涉及到图片主体区域

image.png

image.png

透明字块

区域

原图

消除后的图片

涉及到图片主体区域

image.png

image.jpeg

不涉及到图片主体区域

image.png

image.jpeg

牛皮癣

区域

原图

消除后的图片

涉及到图片主体区域

image.jpeg

image.jpeg

不涉及到图片主体区域

image.png

image.jpeg

接口 

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 至 3000×3000；文件 ≤ 10 MB。

ObjectRemoveElements

Number[]

二选一

主体区域上要消除的元素枚举值数组，取值 1-4。与 NonObjectRemoveElements 不可同时为空（除非传 Mask）。

NonObjectRemoveElements

Number[]

二选一

非主体区域上要消除的元素枚举值数组，取值 1-4。

Mask

String

否

精确消除区域，RLE 编码，常配合 Aidge 控制台的图片编辑器使用。传入后 优先生效 ，会忽略 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://img.alicdn.com/.../O1CN01XkuScp1ZRzNjcHUns.jpg",
  "ObjectRemoveElements": [3],
  "NonObjectRemoveElements": [1, 2, 4]
}

响应示例 

{
  "Data": {
    "ImageUrl": "https://oss.aliyuncs.com/.../09e817cf-removed.png",
    "Height": 1920,
    "UsageMap": { "ProcessedImageCount": 1 },
    "Width": 1920
  },
  "RequestId": "EE09B075-FF84-1282-8F7E-5AC58FFD3A5B",
  "Message": "Success",
  "Code": "success",
  "Success": true
}

使用建议

  • 仅消除非主体区域：电商主图通常只需要去掉背景的促销文字，保留主体上的产品标签。这种场景只传 NonObjectRemoveElements 即可。

  • 主体上有大面积文字：如 T 恤胸前的品牌 logo。直接消除可能影响主体完整度，建议先用智能元素识别评估，再决定是否消除。

  • 精确消除指定区域 ：当自动识别无法精确覆盖目标（如形状不规则的水印）时，可通过 API 传入 Mask 参数指定要消除的区域。

错误码

错误码

触发场景

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 将在控制台提供，支持图片编辑器编辑。

后续步骤

  • 智能元素识别 -- 配合本接口的"先识别后消除"链路第一步。

  • 智能出图 -- 把识别 + 消除 + 翻译 + 扩展等能力串联为异步任务。

  • 智能抠图 -- 消除后再做主体抠出。

上一篇：智能抠图下一篇：智能裁剪