API 文档

有奖调研

图片同步审核

最近更新时间:2021-11-29 16:55:58

功能描述

图片审核功能为同步请求方式,您可以通过本接口对图片文件进行内容审核。该接口属于 GET 请求。

该接口支持情况如下:

  • 支持对 COS 上的图片文件或链接进行检测,通过深度学习技术,识别可能令人反感、不安全或不适宜的违规图片内容。
  • 支持对 GIF 图进行截帧审核。
  • 支持识别多种违规场景,包括:低俗、违法违规、色情、广告等场景。
  • 支持多种物体检测(实体、广告台标、二维码等)及图片中文本的 OCR 文本识别。
  • 支持根据不同的业务场景配置自定义的审核策略。
  • 支持用户自定义选择图片风险库,打击自定义识别类型的违规图片(目前仅支持黑名单配置)。

费用说明

  • 每个审核场景单独计费,例如您选择审核涉黄、广告两种场景,则审核1张图片,计2次审核费用。
  • 图片审核每日有2000次的免费审核额度,未用完的额度不累计至下一天。
  • 调用接口会产生 图片审核费用COS 读请求费用
  • 如果图片为 COS 上的低频存储类型,调用审核会产生 COS 低频数据取回费用
  • 不支持审核 COS 上的归档存储类型和深度归档存储类型的文件,如果需要审核此类型文件,请先 恢复归档文件

限制说明

  • 图片文件大小支持:文件 < 5MB
  • 图片文件分辨率支持:建议分辨率大于256x256,否则可能会影响识别效果。
  • 图片文件支持格式:PNG、JPG、JPEG、BMP、GIF、WEBP 格式。暂不支持审核涉及二维码广告类的 WEBP 格式图片。
  • 支持审核的图片文件:图片文件链接、腾讯云 COS 上的图片文件。
  • 图片文件链接支持的传输协议:HTTP、HTTPS。
  • 调用接口需携带签名,具体规则请参见 请求签名 文档。

请求

请求示例

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

说明:

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

请求头

此接口仅使用公共请求头部,详情请参见 公共请求头部 文档。

请求参数

具体参数如下:

参数名称 描述 类型 是否必选
ObjectKey COS 存储桶中的图片文件名称,COS 存储桶由Host指定,例如在北京的 examplebucket-1250000000存储桶中的目录 test 下的文件 img.jpg,则Host填写 examplebucket-1250000000.cos.ap-beijing.myqcloud.com,ObjectKey填写 test/img.jpg String
ci-process 标识数据处理功能的字段,内容审核的值为:sensitive-content-recognition String
detect-type 审核类型,拥有 porn(涉黄识别)、terrorist(涉暴恐识别)、politics(涉政识别)、ads(广告识别)四种。用户可选择多种识别类型,例如 detect-type=porn,ads 表示对图片进行涉黄及广告审核 String
detect-url 您可以通过填写detect-url审核任意公网可访问的图片链接
  • 不填写detect-url时,后台会默认审核ObjectKey
  • 填写了detect-url时,后台会审核detect-url链接,无需再填写ObjectKey
    detect-url示例:http://www.example.com/abc.jpg
  • String
    interval 审核 GIF 动图时,可使用该参数进行截帧配置,代表截帧的间隔。例如值设为5,则表示从第1帧开始截取,每隔5帧截取一帧,默认值5 Int
    max-frames 针对 GIF 动图审核的最大截帧数量,需大于0。例如值设为5,则表示最大截取5帧,默认值为5 Int
    biz-type 审核策略,不填写则使用默认策略。可在控制台进行配置,详情请参见 设置公共审核策略 String
    注意:

    • 通过 ObjectKey 进行审核为内网操作,不会产生额外的外网流量。
    • 通过 detect-url 进行审核,会产生图片所在源站对应的外网流量。

    请求体

    该请求的请求体为空。

    响应

    响应头

    此接口仅返回公共响应头部,详情请参见 公共响应头部 文档。

    响应体

    <RecognitionResult>
          <Result>1</Result>
          <Label>Porn</Label>
          <SubLabel>SexBehavior</SubLabel>
          <Score>90</Score>
          <PornInfo>
              <Code>0</Code>
              <Msg>OK</Msg>
              <HitFlag>1</HitFlag>
              <Label>xxx</Label>
              <SubLabel>SexBehavior</SubLabel>
              <Score>100</Score>
              <OcrResults>
                <Text></Text>
                <Keywords></Keywords>
                <Location>
                  <X></X>
                  <Y></Y>
                  <Width></Width>
                  <Height></Height>
                  <Rotate></Rotate>
                </Location>
              </OcrResults>
          </PornInfo>
          <PoliticsInfo>
              <Code>0</Code>
              <Msg>OK</Msg>
              <HitFlag>0</HitFlag>
              <Label>xxx</Label>
              <SubLabel></SubLabel>
              <Score>10</Score>
              <ObjectResults>
                <Name></Name>
              </ObjectResults>
          </PoliticsInfo>
    </RecognitionResult>

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

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

    RecognitionResult 节点内容:

    参数名称 类型 描述
    Result Int 该字段表示本次判定的审核结果,您可以根据该结果,进行后续的操作;建议您按照业务所需,对不同的审核结果进行相应处理。
    有效值:0(审核正常),1 (判定为违规敏感文件),2(疑似敏感,建议人工复核)
    Label String 该字段用于返回检测结果中所对应的优先级最高的恶意标签,表示模型推荐的审核结果,建议您按照业务所需,对不同违规类型与建议值进行处理。
    返回值:Normal 表示正常,Porn 表示色情,Ads 表示广告,Politics 表示涉政,Terrorism 表示暴恐
    SubLabel String 该图命中的二级标签结果
    Score Int 该字段表示审核结果命中审核信息的置信度,取值范围:0(置信度最低)-100(置信度最高 ),越高代表该内容越有可能属于当前返回审核信息
    例如:色情 99,则表明该内容非常有可能属于色情内容
    Text String 该图里的文字内容(OCR),当审核策略开启文本内容检测时返回
    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(置信度最低)-100(置信度最高),越高代表该内容越有可能属于当前返回审核信息。
    其中0 - 60分表示图片正常,61 - 90分表示图片疑似敏感,91 - 100分表示图片确定敏感
    例如:色情 99,则表明该内容非常有可能属于色情内容
    Label String 该字段表示该截图的综合结果标签(可能为 SubLabel,可能为人物名字等)
    SubLabel String 该字段表示审核命中的具体子标签,例如:Porn 下的 SexBehavior 子标签。
    注意:该字段可能返回空,表示未命中具体的子标签
    OcrResults Container Array 该字段表示 OCR 文本识别的详细检测结果,包括文本识别结果、命中的关键词等信息,有相关违规内容时返回
    ObjectResults Container Array 该字段表示审核到的一些具体结果,例如:政治人物名称
    注意:该字段仅在 PoliticsInfo 中,有相关违规内容时返回

    Container 节点 OcrResults 的内容:

    参数名称 类型 描述
    Text String 图片 OCR 文本识别出的具体文本内容
    Keywords String Array 在当前审核场景下命中的关键词
    Location Container 该参数用于返回 OCR 检测框在图片中的位置(左上角 xy 坐标、长宽、旋转角度),以方便快速定位识别文字的相关信息

    Container 节点 Location 的内容:

    名称 类型 描述
    X Float 该参数用于返回检测框左上角位置的横坐标(x)所在的像素位置,结合剩余参数可唯一确定检测框的大小和位置
    Y Float 该参数用于返回检测框左上角位置的纵坐标(y)所在的像素位置,结合剩余参数可唯一确定检测框的大小和位置
    Width Float 该参数用于返回检测框的宽度(由左上角出发在 x 轴向右延伸的长度),结合剩余参数可唯一确定检测框的大小和位置
    Height Float 该参数用于返回检测框的高度(由左上角出发在 y 轴向下延伸的长度),结合剩余参数可唯一确定检测框的大小和位置
    Rotate Float 该参数用于返回检测框的旋转角度,该参数结合 X 和 Y 两个坐标参数可唯一确定检测框的具体位置;取值:0-360角度制),方向为逆时针旋转

    Container 节点 ObjectResults 的内容:

    名称 类型 描述
    Name String 该标签用于返回所识别出的实体名称,例如人名。
    Location Container 该参数用于返回检测结果在图片中的位置(左上角 xy 坐标、长宽、旋转角度),以方便快速定位相关信息。

    实际案例

    请求

    GET /picture.jpg?ci-process=sensitive-content-recognition&detect-type=porn&interval=0&max-frames=1&biz-type=*** 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>
          <Result>1</Result>
          <Label>Porn</Label>
          <SubLabel>SexBehavior</SubLabel>
          <Score>95</Score>
          <PornInfo>
              <Code>0</Code>
              <Msg>OK</Msg>
              <HitFlag>1</HitFlag>
              <Label>xxx</Label>
              <SubLabel>SexBehavior</SubLabel>
              <Score>95</Score>
          </PornInfo>
    </RecognitionResult>

    目录