简介
本文档提供关于图像智能裁剪的相关 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 = 0;// 需要裁剪区域的高度,与width共同组成所需裁剪的图片宽高比例;输入数字请大于0、小于图片高度的像素值;width : height建议取值在[1, 2.5]之间,超过这个范围可能会影响效果;是否必传:true;request.height = 0;// 是否严格按照 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 = QCloudAIImageCropRequest();// 设置:objectKey;request.objectKey = "objectKey";request.bucket = "sample-1250000000";request.regionName = "COS_REGIONNAME";// 数据万象处理能力,智能裁剪固定为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 = 0;// 需要裁剪区域的高度,与width共同组成所需裁剪的图片宽高比例;输入数字请大于0、小于图片高度的像素值;width : height建议取值在[1, 2.5]之间,超过这个范围可能会影响效果;是否必传:true;request.height = 0;// 是否严格按照 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.finishBlock = { result, error in// 无响应体};QCloudCOSXMLService.defaultCOSXML().aiImageCrop(request);
注意: