文档中心

AI MediaKit

图像工具 API

提交电商牛皮癣擦除任务 API

POST https://mediakit.cn-beijing.volces.com/api/v1/tools-sync/remove-image-elements

本 API 用于提交一个同步的电商牛皮癣擦除任务，可自动检测并擦除商品图中的水印、Logo、促销贴纸、价格标签和多余文字，输出更干净、更适合二次流转和再创作的商品图，整个过程无需人工框选即可完成，适用于电商搬家、商品图净化、素材二次创作等场景。默认输出 PNG 格式图像。

请求参数

Header 参数

参数	类型	是否必选	示例值	描述
Authorization	String	是	Bearer {Your_API_Key}	格式为 Bearer {Your_API_Key}。请参考基础概念及准备工作获取 API Key。

Body 参数

参数	类型	是否必选	示例值	描述
image_url	String	是	https://example.com/product.jpg	待清理的图片 URL。图像来源：支持公网 HTTP/HTTPS URL、本地上传 (mediakit://)、火山引擎对象存储 (tos://) 三种输入协议。关于各协议的具体说明和使用示例，请参阅多源媒体输入与本地上传。文件大小：建议不超过 10MB，图片文件过大可能导致处理失败。分辨率限制： 128 px ≤ 高度 ≤ 1440 px 128 px ≤ 宽度 ≤ 2560 px 支持格式：支持 .png、.jpg、.jpeg、.webp 等主流图像格式，不支持动图。
queue_id	String	否	q00a973...	任务提交的目标队列 ID。如不传，默认会使用系统自动创建的队列 ID。您可以将不同业务或优先级的任务提交到不同的队列，以实现按队列对应的项目进行分账。您可以在 AI MediaKit 控制台队列管理页面创建和管理队列，系统会自动分配一个队列 ID。详情请参考项目与队列管理。

请求示例

以下示例演示了如何为一个商品图提交牛皮癣擦除任务。

响应说明

成功响应

请求处理成功后，接口会直接返回包含处理结果的 JSON 对象，其主要字段结构如下。

参数	类型	描述
success	Boolean	任务是否成功。 true：成功。 false：失败。更多信息请查看错误响应。
task_id	String	任务的唯一标识。
task_type	String	任务类型。对于本 API，取值为 remove-image-elements。
request_id	String	本次 API 请求的唯一标识，可用于问题排查。
expires_at	Integer	任务结果的过期时间戳（Unix Time，单位：秒）。仅当任务成功且有结果时返回。
result	Object	包含图像处理结果的对象。详见下文 result 结构。

result 结构

参数	类型	描述
image_url	String	清理后的图片文件下载地址。该地址的有效期为 24 小时，请务必及时保存产物。
image_size	Integer	生成图像的大小，单位为字节。
image_format	String	生成图像的格式，例如 png。
image_width	Integer	生成图像的宽度，单位为 px。
image_height	Integer	生成图像的高度，单位为 px。

响应示例：

错误响应

当请求的参数或鉴权信息不正确时，接口会返回一个同步的错误响应。详见错误码。响应示例：

最近更新时间：2026.06.17 20:33:01

这个页面对您有帮助吗？

有用

无用