智能裁剪API调用说明

智能裁剪

GET/POST /ai/image/cropping

产品描述

图像裁剪产品可以对输入的图像按照指定尺寸进行变换，支持自动识别图片主体区域，精准裁剪出各类尺寸，适配各种场景的设计需求。

请求参数

参数	类型	必填	参数描述及示例值
imageUrl	String	No	图片URL。 与imageBase64不能同时为空。如果同时存在imageUrl和imageBase64，优先取 Base64。 图片尺寸应该大于100*100像素，小于5000*5000像素。
imageBase64	String	No	图片的Base64编码。 与imageUrl不能同时为空。如果同时存在imageUrl和imageBase64，优先取 Base64。 图片尺寸应该大于512*512像素，小于3000*3000像素。
targetWidth	Int	Yes	期望裁剪成的图片宽度。 单位：像素。取值范围：100-5000。 示例值：800
targetHeight	Int	Yes	期望裁剪成的图片高度。 单位：像素。取值范围：100-5000。 示例值：800

请求示例

Java

IopClient client = new IopClient(url, appkey, appSecret);
IopRequest request = new IopRequest();
request.setApiName("/ai/image/cropping");
request.addApiParameter("imageBase64", "\u56FE\u7247base64\u683C\u5F0F");
request.addApiParameter("targetHeight", "200");
request.addApiParameter("imageUrl", "https://ae01.alicdn.com/kf/S99cb7e78ba2b46cc9134b87c323bb617x.png");
request.addApiParameter("targetWidth", "200");
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": {
    "imageUrl": "https://ai-business-algo-pai.oss-ap-southeast-1.aliyuncs.com/ai_computing%2Ftmp%2F76cfdba6-414c-4cae-9fd8-2f0bedd014ab.png?OSSAccessKeyId=LTAI5tAGoBnm5eYsnZ5E1zMr&Expires=4935905941&Signature=KXlHdonXT6ktAlqw5x5wLHLy9uk%3D",
    "usage": 1,
    "width": 1000,
    "class": "com.aidc.service.api.client.image.dto.ImageGenResponse",
    "height": 1000
  },
  "requestId": "21410ce717192339411452275ea831",
  "success": true,
  "resCode": 200,
  "resMessage": "success",
  "code": "0",
  "request_id": "212a664f17192339411465542",
  "_trace_id_": "21410ce717192339411452275ea831"
}

错误码

错误码	错误信息	描述
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，入群联系我们。