简介
本文档提供关于图像智能裁剪的相关 API 概览以及 SDK 示例代码。
API | 操作描述 |
腾讯云数据万象通过 AIImageCrop 接口对图像进行智能裁剪,支持持久化、云上处理及下载时处理。 |
SDK API 参考
图像智能裁剪
功能说明
腾讯云数据万象通过 AIImageCrop 接口对图像进行智能裁剪,支持持久化、云上处理及下载时处理。
说明:
COS iOS SDK 版本需要大于等于 v6.2.9。
示例代码
Objective-C
QCloudAIImageCropRequest * request = [QCloudAIImageCropRequest new];request.bucket = @"sample-1250000000";request.regionName = @"COS_REGIONNAME";// 设置:ObjectKey;request.ObjectKey = @"";// 数据万象处理能力,智能裁剪固定为AIImageCrop;是否必传:true;request.ciProcess = @"AIImageCrop";// 您可以通过填写 detect-url 处理任意公网可访问的图片链接。不填写 detect-url 时,后台会默认处理 ObjectKey ,填写了 detect-url 时,后台会处理 detect-url 链接,无需再填写 ObjectKey detect-url 示例:http://www.example.com/abc.jpg ,需要进行 UrlEncode,处理后为http%25253A%25252F%25252Fwww.example.com%25252Fabc.jpg;是否必传:false;request.detectUrl = @"";// 需要裁剪区域的宽度,与height共同组成所需裁剪的图片宽高比例;输入数字请大于0、小于图片宽度的像素值;是否必传:true;request.width = 100;// 需要裁剪区域的高度,与width共同组成所需裁剪的图片宽高比例;输入数字请大于0、小于图片高度的像素值;width : height建议取值在[1, 2.5]之间,超过这个范围可能会影响效果;是否必传:true;request.height = 100;// 是否严格按照 width 和 height 的值进行输出。取值为0时,宽高比例(width : height)会简化为最简分数,即如果width输入10、height输入20,会简化为1:2;取值为1时,输出图片的宽度等于width,高度等于height;默认值为0;是否必传:false;request.fixed = 0;// 当此参数为1时,针对文件过大等导致处理失败的场景,会直接返回原图而不报错;是否必传:false;request.ignoreError = 0;[request setFinishBlock:^(id outputObject, NSError *error) {// 无响应体}];[[QCloudCOSXMLService defaultCOSXML] AIImageCrop:request];
注意:
Swift
let request = QCloudAIImageCropRequest()request.bucket = "sample-1250000000"request.regionName = "COS_REGIONNAME"// 设置:ObjectKeyrequest.objectKey = ""// 数据万象处理能力,智能裁剪固定为 AIImageCrop;是否必传:truerequest.ciProcess = "AIImageCrop"// 可通过 detect-url 处理任意公网可访问的图片链接。不填时默认处理 ObjectKey;// 填写后处理 detect-url 链接,无需再填 ObjectKey。// detect-url 需 UrlEncode,示例:http://www.example.com/abc.jpg// 处理后为 http%25253A%25252F%25252Fwww.example.com%25252Fabc.jpg;是否必传:falserequest.detectUrl = ""// 需要裁剪区域的宽度,与 height 共同组成裁剪的图片宽高比例;// 输入数字请大于 0、小于图片宽度的像素值;是否必传:truerequest.width = 100// 需要裁剪区域的高度,与 width 共同组成裁剪的图片宽高比例;// 输入数字请大于 0、小于图片高度的像素值;// width : height 建议取值在 [1, 2.5] 之间,超过范围可能影响效果;是否必传:truerequest.height = 100// 是否严格按照 width 和 height 的值输出。0:宽高比例会简化为最简分数(如 10:20 简化为 1:2);// 1:输出图片宽度等于 width、高度等于 height;默认值为 0;是否必传:falserequest.fixed = 0// 为 1 时,针对文件过大等导致处理失败的场景,直接返回原图而不报错;是否必传:falserequest.ignoreError = 0request.setFinishBlock { _, error in// 无响应体,成功失败只看 errorif let error = error {// 处理失败} else {// 处理成功,结果为裁剪后的图片数据}}QCloudCOSXMLService.defaultCOSXML().aiImageCrop(request)
注意: