异常图片检测同步请求

最近更新时间:2024-06-11 10:30:51

我的收藏

功能概述

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


授权说明

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

服务开通

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

使用限制

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

接口示例

GET /<ObjectKey>?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

实际案例

对存储桶examples-1251000004中的文件sample.jpeg进行异常检测,示例如下:
http://examples-1251000004.cos.ap-shanghai.myqcloud.com/sample.jpeg?imageInspect

响应结果

{
"picSize": 158421,
"picType": "jpeg",
"suspicious": false
}