AI 助理
文档备案控制台
官方文档
首页 电商经营助手 开发参考 素材优化 智能消除（异步）

智能消除（异步）

更新时间：
复制 MD 格式
产品详情
我的收藏

1、产品简介

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

2、适用场景

  • 电商图片高效处理：

清除无关的视觉元素，提供更清晰、专注的商品展示，增强顾客的购物体验；

  • 多平台商品信息同步：

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

  • 营销素材准备：

商家可轻松去除原有的促销信息，快速更新为最新的活动信息；

注：商家或平台可以批量移除图片中的杂质以优化图片质量。我们建议与“智能识别 API”结合使用（近期会上线），首先筛选出含有文字、特定名称、透明字块和牛皮癣的图片，然后使用“智能消除 API”进行批量移除。智能识别 API 专注于“识别”，而智能消除 API专注于“消除”。通过按顺序调用它们，可以最大限度地提高消除效果，减少“误移除”和“误识别”。

3、功能介绍

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

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

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

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

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

    2. （升级）提供指定图片消除，用户可一次指定多个图片

    3. （升级）提供指定文字消除，用户可一次指定多个文字

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

4、效果对比

可消除图片内的对象

原图

消除后的图片

文字

  • 涉及到图片主体区域

image.png

  • 不涉及到图片主体区域

image.png

  • 涉及到图片主体区域

image.png

  • 不涉及到图片主体区域

image.png

特定名称

  • 涉及到图片主体区域

image.png

  • 不涉及到图片主体区域

image.png

  • 涉及到图片主体区域

image.png

  • 不涉及到图片主体区域

image.png

透明字块

  • 涉及到图片主体区域

image.png

  • 不涉及到图片主体区域

image.png

  • 涉及到图片主体区域

image.jpeg

  • 不涉及到图片主体区域

image.jpeg

牛皮癣

  • 涉及到图片主体区域

image.jpeg

  • 不涉及到图片主体区域

image.png

  • 涉及到图片主体区域

image.jpeg

  • 不涉及到图片主体区域

image.jpeg

指定图像元素消除（支持多图像链接）

image.png

image.png

指定文本消除（支持多文字）

image.png

image.png

5、开发指南

5.1请求参数

参数名称

类型

必填

参数描述及示例值

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

5.2请求示例

{
  "ImageUrl": "https://aib-innovation-oss.oss-accelerate.aliyuncs.com/AI_Business/asTYo/removaltest2.png?Expires=3356502130&OSSAccessKeyId=LTAI5tE8X3gEy66SRU1V8dig&Signature=QI%2BNEcHO%2FNCMgNnx5lv%2B0JxQ7KE%3D",
  "NonObjectRemoveElements": null,
  "ObjectRemoveElements": [
    1,
    2,
    4
  ],
  "Mask": null,
  "UserText": [
    "科技",
    "秘密武器"
  ],
  "UserImage": [
    "xxxxxxxxx",
    "xxxxxxxxx"
  ]
}

5.3响应参数

参数名

类型

描述

Code

String

状态码，如"success"

Success

Boolean

是否成功：true代表成功，false代表失败

Message

String

报错信息，例如“参数中包含敏感信息，请尝试其他输入”。

RequestId

String

请求ID：用来识别唯一一次请求调用

Data

Object

返回的结果结构体信息

Data.ImageUrl

String

处理后的结果图片URL

Data.Width

Number

输出图像宽度（像素）

Data.Height

Number

输出图像高度（像素）

Data.UsageMap

Object

用量字段

Data.UsageMap.ProcessedImageCount

Number

已处理图片数量

5.4响应示例

{
  "Data": {
    "ImageUrl": "http://dashscope-7c2c.oss-cn-shanghai.aliyuncs.com/7d/25/20260813/909f6051/feb09c19-e7f7-4b64-856d-0c83cac288b0.jpg?Expires=1789198273&OSSAccessKeyId=LTAI5tPxpiCM2hjmWrFXrym1&Signature=bXySUcguJBqgnVBnmtKHBTK4EhM%3D",
    "Height": 896,
    "UsageMap": {
      "ProcessedImageCount": 1
    },
    "Width": 692
  },
  "RequestId": "019FFA08-2261-19C1-A546-0137FD063D3B",
  "Message": "Success",
  "Code": "success",
  "Success": true
}

6、接入准备与调用流程

6.1 前置说明

智能消除 支持同步和异步两种调用方式。本文介绍异步调用接口，如需使用同步调用，请参阅智能消除。

智能消除 及其他能力的异步接口共用结果获取流程、RocketMQ 订阅规则、消息加密协议、依赖配置，以及 Java 消费与解密代码。

异步调用的接入流程，订阅规则，消息格式与加密协议，以及详细的接入方案请参阅异步接口调用说明。

7、计费方式

¥0.025元/张

8、使用限制

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

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

  • 计费：按 ProcessedImageCount 计件。

9、常见问题

  1. 物体被文字遮挡时，消除文字后是否支持生成全新的这部分被遮挡的区域？

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

  1. 如果智能消除API的自动消除效果不理想，用户是否有办法进行手动调整？

通过编辑器接入方式，用户可以进行手动调整，在编辑器内手动涂抹/框选/圈选需要消除的选区。编辑器能力后续aidge会提供控制台，可支持图片编辑器编辑

上一篇：智能元素识别（异步）下一篇：智能消除 Pro（异步）