功能概述
对象存储通过数据万象 ImageInspect 接口检测图片中是否隐含其他类型的可疑文件。
注意
授权说明
服务开通
使用限制
支持格式:JPG/JPEG、PNG、BMP、WebP、GIF,以及纯 TS 视频流(更改为任意后缀)。
静态图体积限制:可检测的原图大小不超过32MB,宽高不超过50000像素且总像素不超过2.5亿像素。
动图体积限制:原图及处理图宽 x 高 x 帧数不超过2.5亿像素。
动图帧数限制:gif 帧数限300帧。
接口示例
GET /<ObjectKey>?ci-process=ImageInspect HTTP/1.1Host: <BucketName-APPID>.cos.<Region>.myqcloud.comDate: <GMT Date>Authorization: <Auth String>
处理参数说明
请求参数
操作名称:ImageInspect。
参数 | 含义 | 类型 | 是否必选 |
ObjectKey | 对象文件名,例如 folder/sample.jpg | String | 是 |
响应参数
参数 | 含义 | 类型 |
picSize | 检测的原图大小,单位为 Bytes | String |
picType | 检测的原图类型。例如 jpg、png 等 | String |
suspicious | 是否检测到图片格式以外的文件。false 为正常图片文件,true 表示含有其他格式的可疑文件 | Boolean |
suspiciousBeginByte | 检测到的可疑文件的起始字节位置,单位为 Bytes | String |
suspiciousEndByte | 检测到的可疑文件的末尾字节位置,单位为 Bytes | String |
suspiciousSize | 检测到的可疑文件的大小 | String |
suspiciousType | 检测到的可疑文件的类型,例如 MPEG-TS | String |
实际案例
该接口需要携带签名进行使用,签名与检测参数以“&”连接,示例如下:
http://examples-1251000004.cos.ap-shanghai.myqcloud.com/sample.jpeg?q-sign-algorithm=<signature>&ci-process=ImageInspect
说明
响应结果
Content-Length: 156Content-type: application/json; charset=utf-8Date: Wed, 20 Sep 2023 10:02:17 GMTETag: "510a46aae64affbc35b01587f95f51bb"Server: tencent-ciStatus: 200 OKx-cos-hash-crc64ecma: 10142439674505xxxx-cos-request-id: NjUwYWMzMjlfNWNkxxxx{"picSize":304491,"picType":"png","suspicious":true,"suspiciousBeginByte":119,"suspiciousEndByte":304490,"suspiciousSize":304372,"suspiciousType":"MPEG-TS"}