智能抠图(异步)

更新时间:
复制 MD 格式

1、产品简介

智能抠图产品可以自动识别图像中的显著性主体,将主体和背景进行分离,返回去除背景后的主体图片。同时该产品还提供多种背景选项及定制尺寸选择,优化商品展示效果。

2、适用场景

  • 支持对素材进行二次编辑:将图像主体和背景进行分离后,可支持用户进一步对图片的二次编辑。

  • 提高素材处理效率:快速提取各类素材图片主体,方便进行背景替换,从而提高广告形象、营销海报的制作效率。

3、功能介绍

1. 一键精准主体识别

  • AI自动识别:基于深度学习模型,智能区分前景主体(人像、商品、物体等)与背景,无需手动描边。

  • 多场景适配:支持复杂场景(如发丝、透明物体、毛发边缘)的精准分割,准确率超95%。

2. 边缘智能优化

  • 细节级处理:自动优化边缘锯齿、半透明区域(如烟雾、玻璃),保留自然过渡效果。

3. 多格式输出与背景操作

  • 透明背景导出:直接生成PNG透明底图和白底图,适配电商、设计等场景。

  • 支持对背景自定义背景颜色

4、效果对比

原始图片 (输入)

结果图片 (输出)

image

image

image

image

image

image

5、开发指南

5.1请求参数

参数名称

类型

必填

参数描述及示例值

backGroundType

String

是

指定返回的图像背景形式。

取值范围:

-WHITE_BACKGROUND:返回白底图

- TRANSPARENT:返回透明图

示例值:"WHITE_BACKGROUND"

ImageUrl

String

是

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

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

TargetWidth

String

否

期望裁剪成的图片宽度。(不填写默认为图片原尺寸)

单位:像素。取值范围:100–5000。

示例值:800

TargetHeight

String

否

期望裁剪成的图片高度。(不填写默认为图片原尺寸)

单位:像素。取值范围:100–5000。

示例值:800

bgColor

String

否

背景BGR色彩值,默认值为白色

示例值:"255,255,255"

5.2请求示例

{
  "TargetHeight": 800,
  "BgColor": "255,255,255",
  "ImageUrl": "https://aib-innovation-oss.oss-accelerate.aliyuncs.com/AI_Business/CTqd9/ImageMatting-1?Expires=3356508287&OSSAccessKeyId=LTAI5tE8X3gEy66SRU1V8dig&Signature=LT5UtAp%2B1Rch7Eu2UqTj5kvurww%3D",
  "BackGroundType": "WHITE_BACKGROUND",
  "TargetWidth": 800
}

5.3响应参数

参数名

类型

描述

Code

String

状态码,如"success"

Success

Boolean

是否成功:true代表成功,false代表失败

RequestId

String

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

Data

Object

返回的结果结构体信息

Data.ImageUrl

String

处理后的结果图片URL

Data.Score

Number

图像质量评分

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/4a/20260525/f3547444/52033655bd054737960a87518655d935_202605251926_5.959999978542328.jpg?Expires=1782300370&OSSAccessKeyId=LTAI5tPxpiCM2hjmWrFXrym1&Signature=XskJ9GEdikVhbBz7DfgbESj5xJ0%3D",
    "Score": 5.959999978542328,
    "Height": 800,
    "UsageMap": {
      "ProcessedImageCount": 1
    },
    "Width": 800
  },
  "RequestId": "7BEDF90E-D04E-1430-BDAE-18A31F84A348",
  "Message": "Success",
  "Code": "success",
  "Success": true
}

5.5错误码

详见错误码

6、接入准备与调用流程

6.1前置说明

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

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

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

7、计费方式

¥0.002元/张

8、使用限制

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

  • 输入图片:JPG / JPEG / PNG / BMP / WEBP;分辨率应在100×100至3000x3000像素之间,文件大小不超过10MB

  • 计费:按 ProcessedImageCount 计件。详见 素材优化计费 。

9、常见问题

  1. 智能抠图在不同类型图片效果有什么差异?

智能抠图产品在处理主体占比大、完整、单主体或多个明确主体的电商商品主图上表现效果更好,但对于透明等特殊材质的商品图片、主体不明确的图片的抠图会有一定程度的处理偏差和错误,如产品使用步骤图、局部细节图、SKU拼图等。

  1. 抠图后,主体的像素、质量等会下降吗?

不会。当入参时不填入目标宽高,抠图结果会返回原图尺寸,不会影响抠出主体的质量。但当入参时设置了目标宽高,且与原图尺寸不一致时,抠图结果会返回目标尺寸,且会对主体做缩放等处理。当目标尺寸与原图差距过大时,可能会影响质量。