API 文档

图片审核

最近更新时间:2020-07-17 17:33:44

功能概述

图片审核的存量扫描功能通过借助数据万象的持久化处理接口,实现对 COS 存量数据的涉黄、涉政、涉暴恐以及广告引导类图片的扫描。图片审核请求包属于 GET 请求。

注意:

  • 调用图片审核 API 接口需携带签名,具体规则请参见 请求签名 文档。
  • 当前图片审核的图片限制为:图片格式支持 PNG、JPEG、JPG,图片大小不超过3MB,图片宽高大于50像素 x 50像素。

请求语法

GET /<ObjectKey>?ci-process=sensitive-content-recognition&detect-type=<type> HTTP/1.1
Host: <BucketName-APPID>.cos.<Region>.myqcloud.com
Date: GMT Date
Authorization: Auth String
说明:

Authorization: Auth String(详情请参见 请求签名 文档。)

请求内容

Content-Recognition 为 json 格式的字符串,具体参数如下:

参数名称 描述 类型 是否必选
ObjectKey 对象文件名,例如 picture.jpg Sting
type 审核类型,拥有 porn(涉黄识别)、terrorist(涉暴恐识别)、politics(涉政识别)、ads(广告识别)四种,用户可选择多种识别类型,例如 detect-type=porn,ads 表示对图片进行涉黄及广告审核 String

返回内容

响应包体具体数据内容如下:

参数名称 类型 描述
RecognitionResult Container 图片审核结果

RecognitionResult 节点内容:

参数名称 类型 描述
PornInfo Container 鉴黄审核信息
TerroristInfo Container 鉴暴恐审核信息
PoliticsInfo Container 鉴政审核信息
AdsInfo Container 广告审核信息

审核信息(PornInfo、TerroristInfo、PoliticsInfo、AdsInfo)中包含如下内容:

参数名称 类型 描述
Code Int 错误码,0为正确,其他数字对应相应错误。详情请参见 错误码
Msg String 具体错误信息,如正常则为 OK
HitFlag Int 是否命中该审核分类,0表示未命中,1表示命中,2表示疑似
Score Int 审核分值。0 - 60分表示图片正常,60 - 90分表示图片疑似敏感,90 - 100分表示图片确定敏感
Label String 识别出的图片标签
Count Int 视频文件参数,该类型违规的截图张数

示例

请求

GET /picture.jpg?ci-process=sensitive-content-recognition&detect-type=porn,politics HTTP/1.1
Host: examplebucket-1250000000.cos.ap-chengdu.myqcloud.com
Date: Tue, 03 Apr 2019 09:06:15 GMT
Authorization:XXXXXXXXXXXX

响应

HTTP/1.1 200 OK
Content-Type: application/xml
Content-Length: 645
Date: Tue, 03 Apr 2018 09:06:16 GMT
Status: 200 OK
x-cos-request-id: NWFjMzQ0MDZfOTBmYTUwXzZkZV8z****

<RecognitionResult>
   <PornInfo>
      <Code>0</Code>
      <Msg>OK</Msg>
      <HitFlag>1</HitFlag>
      <Score>100</Score>
      <Label>xxx</Label>
   </PornInfo>
   <PoliticsInfo>
      <Code>0</Code>
      <Msg>OK</Msg>
      <HitFlag>0</HitFlag>
      <Score>10</Score>
      <Label>xx</Label>
   </PoliticsInfo>
</RecognitionResult>
目录