智能抠图API调用说明

智能抠图

GET/POST /ai/image/cut/out

产品描述

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

请求参数

参数	类型	必填	描述Description
backGroundType	String	Yes	指定返回的图像背景形式。如果不设置，默认返回透明图。取值范围： WHITE_BACKGROUND：返回白底图 TRANSPARENT：返回透明图 示例值：WHITE_BACKGROUND
imageUrl	String	No	图片URL。 与imageBase64不能同时为空。如果同时存在imageUrl和imageBase64，优先取 Base64。 图片尺寸应该大于100*100像素，小于3000*5000像素。
imageBase64	String	No	图片的Base64编码。 与imageUrl不能同时为空。如果同时存在imageUrl和imageBase64，优先取 Base64。 图片尺寸应该大于512*512像素，小于3000*3000像素。
targetWidth	Int	No	指定返回的图像宽度。设置后，返回自动裁切主体边缘空白区域，并缩放后的图片。如果不设置，默认返回原图宽度，且不改变主体位置。 单位：像素。取值范围：100-3000 示例值：800
targetHeight	Int	No	指定返回的图像宽度。设置后，返回自动裁切主体边缘空白区域，并缩放后的图片。如果不设置，默认返回原图高度，且不改变主体位置。 单位：像素。取值范围：100-3000 示例值：800

请求示例

Java

IopClient client = new IopClient(url, appkey, appSecret);
IopRequest request = new IopRequest();
request.setApiName("/ai/image/cut/out");
request.addApiParameter("backGroundType", "WHITE_BACKGROUND");
request.addApiParameter("imageBase64", "");
request.addApiParameter("targetHeight", "1000");
request.addApiParameter("imageUrl", "https://ae01.alicdn.com/kf/Sa78257f1d9a34dad8ee494178db12ec8l.jpg");
request.addApiParameter("targetWidth", "800");
IopResponse response = client.execute(request);
System.out.println(response.getBody());
Thread.sleep(10);

响应参数

参数	类型	描述
resCode	Number	返回的结果码，其中200代表成功，详细错误码请参考错误码列表。
data	Object	返回的抠图结果数据。
requestId	String	唯一的请求ID，用于排查问题。
success	Boolean	返回的请求状态，代表请求是否成功。
resMessage	String	返回的请求信息。

响应示例

Java

{
  "data": {
    "score": 0.8799999952316284,
    "imageUrl": "http://nhci-image.oss-ap-southeast-1.aliyuncs.com/data%2Fgeneral_matting_online%2FAIDC_AIB_SERVICE%2F7089bce4c9d1469cb552dd225e28a254_202406261430_0.8799999952316284.jpg?OSSAccessKeyId=LTAI5t7WDuqmGKhsCAdMMfuH&Expires=2719383457&Signature=3z8ybSgwj5Tns3LahE%2FJXPh99Tg%3D",
    "usage": 1,
    "width": 800,
    "class": "com.aidc.service.api.client.image.dto.ImageGenResponse",
    "height": 1000
  },
  "requestId": "2101364217193834573077250e647d",
  "success": true,
  "resCode": 200,
  "resMessage": "success",
  "code": "0",
  "request_id": "21015e2217193834573111639",
  "_trace_id_": "2101364217193834573077250e647d"
}

错误码

错误码	错误信息	描述
500	system error	System error.服务器内部错误
501	rate limit exceed	当前接口已达到限流上限,请搜索Aidge产品咨询&服务群钉钉群号：105455001046，入群联系我们增加当前限制值。
700	invalid input	输入参数的格式不符合要求，resMessage 将返回详细的不符合要求的字段。
801	model failed	内部调用异常，请搜索Aidge产品咨询&服务群钉钉群号：105455001046，入群联系我们进行故障排除。
1000	content has sensitive data, please try other input	内容包含敏感数据，无法处理，请尝试其他输入。
1001	content control failed, please retry	风控服务运行异常，请搜索Aidge产品咨询&服务群钉钉群号：105455001046，入群联系我们。
1002	content risk filter failed, please contact us	风控服务运行异常，请搜索Aidge产品咨询&服务群钉钉群号：105455001046，入群联系我们。