智能消除 Pro 版面向电商图片，自动识别并消除图片中的文字、特定名称、透明字块与牛皮癣，可按需指定消除对象，支持同步与异步两种调用模式。-电商经营助手-阿里云帮助中心

产品简介

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

适用场景

电商图片高效处理：清除无关的视觉元素，提供更清晰、专注的商品展示，增强顾客的购物体验。
多平台商品信息同步：商家在不同电商平台同步上架商品时，可快速消除特定的文字及牛皮癣，符合不同平台的图片规范。

功能介绍

先明确图片主体与图片背景的定义。指定消除对象时，可选择消除范围为图片主体或图片背景区域；支持 API 与编辑器两种接入方式，满足不同类型的需求。

图片主体：图片中的核心产品区域。
图片背景：除产品主体之外的图像其余部分。

可消除的元素包括以下四类：文字、特定名称、透明字块、牛皮癣。

调用模式说明

本能力支持同步和异步两种调用模式，通过请求参数 Async 切换：

模式	适用场景	调用方式
同步调用（默认）	单张图片、实时性要求高	`Async=false`（或不传）：单次请求直接返回处理后的图片 URL。
异步调用	批量处理、大图 / 处理耗时较长	`Async=true`：提交接口返回 `TaskId`，再轮询查询接口获取结果。

接口一：提交任务

提交图片 URL；Async=false（或不传）为同步，直接返回处理结果；Async=true 为异步，返回 TaskId。

接口请求路径以正式发布的接口文档为准。

请求参数

参数名称

类型

是否必填

参数描述及示例值

ImageUrl

String

是

原图 URL。图像需为 JPG / JPEG / PNG / BMP / WEBP 格式，公网可访问。图片尺寸与大小限制因调用模式不同：

• 同步：分辨率 256×256 至 3000×3000 像素，文件 ≤ 10 MB。

• 异步：分辨率大于 256×256，图像长边 ≤ 1920 像素、短边 ≤ 1080 像素，文件 ≤ 5 MB。

示例值："https://example.com/your-image.jpg"

Async

Boolean

否

是否异步调用。默认 false（同步）；不传或传 false 走同步调用，传 true 启用异步调用。

请求示例

同步调用：

{
  "ImageUrl": "https://example.com/your-image.jpg"
}

异步调用（增加 Async=true）：

{
  "ImageUrl": "https://example.com/your-image.jpg",
  "Async": true
}

响应参数

同步模式响应（Async=false 或未传）：Data 直接包含处理结果。

参数名	类型	描述
`Code`	String	状态码，如 `success`。
`Success`	Boolean	是否成功：true 代表成功，false 代表失败。
`Message`	String	报错信息，例如"参数中包含敏感信息，请尝试其他输入"；成功时为 `Success`。
`RequestId`	String	请求 ID，用来识别唯一一次请求调用。
`Data`	Object	返回的结果结构体信息。
`Data.ImageUrl`	String	处理后的结果图片 URL。
`Data.UsageMap`	Object	用量字段。
`Data.UsageMap.ProcessedImageCount`	Number	已处理图片数量。

异步模式响应（Async=true）：仅返回 TaskId，需凭此调用查询接口获取结果。

参数名称	类型	参数描述
`Code`	String	状态码，如 `success`。
`Success`	Boolean	是否成功：true 代表成功，false 代表失败。
`Message`	String	报错信息，`Success` 代表成功。
`RequestId`	String	请求 ID，用来识别唯一一次请求调用。
`Data`	Object	返回的结果结构体信息。
`Data.TaskId`	String	异步任务 ID，用于后续查询任务结果。

响应示例

同步模式响应：

{
  "Data": {
    "ImageUrl": "https://aib-image.oss-ap-southeast-1.aliyuncs.com/ai_desc/xxxxxxxx.jpg",
    "UsageMap": {
      "ProcessedImageCount": 1
    }
  },
  "RequestId": "9894FF16-EC66-1CFC-97FD-4E15EECA0DF5",
  "Message": "Success",
  "Success": true
}

异步模式响应（提交）：

{
  "Data": {
    "TaskId": "8cec9166-4839-95a5-9f4b-c85e9a8dc852"
  },
  "RequestId": "B0853623-B73A-1231-84A5-6184F9A02425",
  "Message": "Success",
  "Success": true
}

接口二：查询任务结果（仅异步模式使用）

使用异步模式提交后，凭提交接口返回的 TaskId 轮询统一异步查询接口获取结果。请求参数、任务状态枚举与轮询建议详见异步结果查询接口。任务完成（Status=COMPLETED）时，Data.Result 为序列化的 JSON 字符串，解析后的 imageUrl 即处理结果图片 URL。

响应参数（关键字段）

参数名	类型	描述
`Data.Status`	String	任务状态，如 `COMPLETED`。
`Data.TaskId`	String	异步任务 ID。
`Data.Result`	String（JSON）	任务执行结果（序列化 JSON 字符串），解析后含 `imageUrl` 字段。
`Data.Result.imageUrl`	String	图像处理结果 URL（`Data.Result` JSON 解析后的 `imageUrl`）。
`Data.UsageMap.ProcessedImageCount`	Number	已处理图片数量。

响应示例

{
  "Data": {
    "Status": "COMPLETED",
    "UsageMap": {
      "ProcessedImageCount": 1
    },
    "TaskId": "8cec9166-4839-95a5-9f4b-c85e9a8dc852",
    "Result": "{\"imageUrl\":\"https://aib-image.oss-ap-southeast-1.aliyuncs.com/ai_desc/xxxxxxxx.jpg\"}"
  },
  "RequestId": "4726E6DF-D702-1EF8-B23E-46181F16482E",
  "Message": "Success",
  "Code": "success",
  "Success": true
}

错误码

智能消除共享平台统一的命名错误码体系，常见错误码：InvalidParameter（图片格式 / 分辨率 / 大小不合规）、InputContentBlocked（图片触发内容安全审核）、DownstreamUnavailable（图片下载失败或下游模型不可用）、FreeQuotaExhausted（试用额度耗尽）、InternalError（系统繁忙）。完整错误码列表参见错误码。

计费方式

按张计费，¥0.12 / 张，按 ProcessedImageCount 计件。详见素材优化计费。

使用限制

调用模式：支持同步与异步两种，默认 QPS = 5，单次同步请求超时上限 30 秒。
输入图片格式：JPG / JPEG / PNG / BMP / WEBP。
同步：分辨率 256×256 至 3000×3000，文件 ≤ 10 MB。
异步：分辨率 ≥ 256×256，图像长边 ≤ 1920 像素、短边 ≤ 1080 像素，文件 ≤ 5 MB。
计费：按 ProcessedImageCount 计件，详见素材优化计费。

后续步骤

智能消除 -- 可按对象枚举精确指定消除范围的标准版。
异步结果查询接口 -- 异步任务结果查询接口。