功能概述
对象存储通过数据万象 ImageInspect 接口检测图片中是否隐含其他类型的可疑文件。
注意:异常图片检测功能为收费项,由数据万象收取,详细的计费说明请参见数据万象 图片处理费用。
限制说明
- 支持格式:支持检测 PNG 后带 TS 视频流、BMP 带 TS 视频流、纯 TS 视频流(仅更改后缀)三种类型的异常图片。
- 体积限制:处理图片原图大小不超过32MB,宽高不超过30000像素且总像素不超过2.5亿像素,处理结果图宽高设置不超过9999像素。针对动图,原图宽 x 高 x 帧数不超过2.5亿像素。
接口示例
GET /<ObjectKey>?ci-process=ImageInspect HTTP/1.1
Host: <BucketName-APPID>.cos.<Region>.myqcloud.com
Date: <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
说明:
<signature>
为签名部分,需要将检测参数也签入签名中,获取方式请参考 请求签名。