帮你快速理解、总结文档立即下载

图像智能裁剪

最近更新时间:2026-10-10 18:24:05
本文档已由 AI 辅助审校
我的收藏

简介

本文档提供关于图像智能裁剪的相关 API 概览以及 SDK 示例代码。
API
操作描述
腾讯云数据万象通过 AIImageCrop 接口对图像进行智能裁剪,支持持久化、云上处理及下载时处理。

SDK API 参考

SDK 所有接口的具体参数与方法说明,请参考 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];

注意:
更多完整示例,请前往 GitHub 查看。
Swift
let request = QCloudAIImageCropRequest()
request.bucket = "sample-1250000000"
request.regionName = "COS_REGIONNAME"
// 设置:ObjectKey
request.objectKey = ""
// 数据万象处理能力,智能裁剪固定为 AIImageCrop;是否必传:true
request.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;是否必传:false
request.detectUrl = ""
// 需要裁剪区域的宽度,与 height 共同组成裁剪的图片宽高比例;
// 输入数字请大于 0、小于图片宽度的像素值;是否必传:true
request.width = 100
// 需要裁剪区域的高度,与 width 共同组成裁剪的图片宽高比例;
// 输入数字请大于 0、小于图片高度的像素值;
// width : height 建议取值在 [1, 2.5] 之间,超过范围可能影响效果;是否必传:true
request.height = 100
// 是否严格按照 width 和 height 的值输出。0:宽高比例会简化为最简分数(如 10:20 简化为 1:2);
// 1:输出图片宽度等于 width、高度等于 height;默认值为 0;是否必传:false
request.fixed = 0
// 为 1 时,针对文件过大等导致处理失败的场景,直接返回原图而不报错;是否必传:false
request.ignoreError = 0
request.setFinishBlock { _, error in
// 无响应体,成功失败只看 error
if let error = error {
// 处理失败
} else {
// 处理成功,结果为裁剪后的图片数据
}
}
QCloudCOSXMLService.defaultCOSXML().aiImageCrop(request)


注意:
更多完整示例,请前往 GitHub 查看。