有奖捉虫:云通信与企业服务文档专题,速来> HOT

功能概述

对象存储通过数据万象 ImageInspect 接口检测图片中是否隐含其他类型的可疑文件。
注意
异常图片检测功能为收费项,由数据万象收取,详细的计费说明请参见数据万象 图片处理费用


授权说明

授权策略中 action 设置为 ci:CreateImageInspectJob 。查看所有 action

服务开通

使用该功能需提前开通数据万象,并绑定存储桶。详情请参见 绑定存储桶

使用限制

使用该接口时,请先确认相关限制条件。详情请参见 使用限制
支持格式:JPG/JPEG、PNG、BMP、WebP、GIF,以及纯 TS 视频流(更改为任意后缀)。
静态图体积限制:可检测的原图大小不超过32MB,宽高不超过50000像素且总像素不超过2.5亿像素。
动图体积限制:原图及处理图宽 x 高 x 帧数不超过2.5亿像素。
动图帧数限制:gif 帧数限300帧。

接口示例

GET /<ObjectKey>?ci-process=ImageInspect HTTP/1.1
Host: <BucketName-APPID>.cos.<Region>.myqcloud.com
Date: <GMT Date>
Authorization: <Auth String>
说明
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>为签名部分,需要将检测参数也签入签名中,获取方式请参考 请求签名

响应结果

Content-Length: 156
Content-type: application/json; charset=utf-8
Date: Wed, 20 Sep 2023 10:02:17 GMT
ETag: "510a46aae64affbc35b01587f95f51bb"
Server: tencent-ci
Status: 200 OK
x-cos-hash-crc64ecma: 10142439674505xxx
x-cos-request-id: NjUwYWMzMjlfNWNkxxxx

{
"picSize":304491,
"picType":"png",
"suspicious":true,
"suspiciousBeginByte":119,
"suspiciousEndByte":304490,
"suspiciousSize":304372,
"suspiciousType":"MPEG-TS"
}