简介
本文档提供关于图像智能裁剪的相关 API 概览以及 SDK 示例代码。
API | 操作描述 |
图像智能裁剪 |
图像智能裁剪
功能说明
腾讯云数据万象通过 AIImageCrop 接口对图像进行智能裁剪，支持持久化、云上处理及下载时处理。
示例代码
def cos_ai_image_crop():# 图像智能裁剪response, data = client.cos_ai_image_crop(Bucket=bucket_name, ObjectKey="test.jpg", # DetectUrl="https://test-125000000.cos.ap-chongqing.myqcloud.com/test.jpeg" Width=100, Height=100, Fixed=1, IgnoreError=0)data.get_stream_to_file('result.jpg') print(response) return response, data
参数说明
调用 cos_ai_image_crop 函数，具体请求参数如下：
参数名称 | 参数描述 | 类型 | 是否必填 |
Bucket | 存储桶名称 | String | 是 |
ObjectKey | 设置对象名称 | String | 是 |
DetectUrl | 您可以通过填写 detect-url 处理任意公网可访问的图片链接。不填写 detect-url 时，后台会默认处理 ObjectKey ，填写了 detect-url 时，后台会处理 detect-url 链接，无需再填写 ObjectKey detect-url 示例： http://www.example.com/abc.jpg | String | 否 |
Width | 需要裁剪区域的宽度，与 height 共同组成所需裁剪的图片宽高比例 输入数字请大于0、小于图片宽度的像素值 | Integer | 是 |
Height | 需要裁剪区域的高度，与width共同组成所需裁剪的图片宽高比例 输入数字请大于0、小于图片高度的像素值 width : height建议取值在[1, 2.5]之间，超过这个范围可能会影响效果 | Integer | 是 |
Fixed | 是否严格按照 width 和 height 的值进行输出。 取值为0时，宽高比例（width : height）会简化为最简分数，即如果width输入10、height输入20，会简化为1：2 取值为1时，输出图片的宽度等于width，高度等于height；默认值为0 | Integer | 否 |
IgnoreError | 当此参数为1时，针对文件过大等导致处理失败的场景，会直接返回原图而不报错 | Integer | 否 |
返回结果说明
response 为响应头， 数据类型为 dict。 data 为图像智能裁剪后的图片。
response内容
响应体data
[pic-content]
