控制台指南

最佳实践

开发者指南

API 文档

SDK 文档

图片同步审核

最近更新时间:2022-05-16 11:21:45

功能描述

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

该接口支持情况如下:

说明:

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

费用说明

  • 每个审核场景单独计费,例如您选择审核涉黄、广告两种场景,则审核1张图片,计2次审核费用。
  • 调用接口会产生 图片审核费用COS 读请求费用
  • 如果图片为 COS 上的低频存储类型,调用审核会产生 COS 低频数据取回费用
  • 不支持审核 COS 上的归档存储类型和深度归档存储类型的文件,如果需要审核此类型文件,请先 恢复归档文件
  • 审核第三方云存储厂商的图片 URL 时,将产生所在云厂商的下行流量费用。

限制说明

  • 图片文件大小支持:支持审核32MB以下的图片。对于大小超过5MB的图片,您需要在调用请求时,使用 large-image-detect 参数。
  • 图片文件分辨率支持:建议分辨率大于256x256,否则可能会影响识别效果。
  • 图片文件支持格式:PNG、JPG、JPEG、BMP、GIF、WEBP 格式。暂不支持审核涉及二维码广告类的 WEBP 格式图片。
  • 图片文件链接支持的传输协议: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
biz-type 表示审核策略的唯一标识,您可以通过控制台上的审核策略页面,配置您希望审核的场景,如涉黄、广告、违法违规等,配置指引: 设置公共审核策略。您可以在控制台上获取到 biz-type。biz-type 填写时,此条审核请求将按照该审核策略中配置的场景进行审核。
biz-type 不填写时,将自动使用默认的审核策略。
String
detect-type (后续不再维护)审核的场景类型,有效值:Porn(涉黄)、Ads(广告)等,可以传入多种类型,不同类型以逗号分隔,例如:Porn,Ads。如您有更多场景的审核需要,请使用 biz-type 参数。 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
    large-image-detect 对于超过大小限制的图片是否进行压缩后再审核,取值为: 0(不压缩),1(压缩)。默认为0。
    注:压缩最大支持32M的图片,且会收取压缩费用。
    Int
    dataid 图片标识,该字段在结果中返回原始内容,长度限制为512字节 String
    注意:

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

    请求体

    该请求的请求体为空。

    响应

    响应头

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

    响应体

    <RecognitionResult>
          <JobId>xxxxxxxxxxxxxxx</JobId>
          <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>
    </RecognitionResult>

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

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

    RecognitionResult 节点内容:

    参数名称 类型 描述
    JobId String 图片审核任务的 ID。
    CompressionResult Int 图片是否被压缩处理,值为 0(未压缩),1(正常压缩)。
    Result Int 该字段表示本次判定的审核结果,您可以根据该结果,进行后续的操作;建议您按照业务所需,对不同的审核结果进行相应处理。
    有效值:0(审核正常),1 (判定为违规敏感文件),2(疑似敏感,建议人工复核)
    Label String 该字段用于返回检测结果中所对应的优先级最高的恶意标签,表示模型推荐的审核结果,建议您按照业务所需,对不同违规类型与建议值进行处理。
    返回值:Normal 表示正常,Porn 表示色情,Ads 表示广告,以及其他不安全或不适宜的类型。
    Category String 该字段为Label的子集,表示审核命中的具体审核类别。例如 Sexy,表示色情标签中的性感类别
    SubLabel String 该图命中的二级标签结果
    Score Int 该字段表示审核结果命中审核信息的置信度,取值范围:0(置信度最低)-100(置信度最高 ),越高代表该内容越有可能属于当前返回审核信息
    例如:色情 99,则表明该内容非常有可能属于色情内容
    Text String 该图里的文字内容(OCR),当审核策略开启文本内容检测时返回
    PornInfo Container 审核场景为涉黄的审核结果信息
    AdsInfo Container 审核场景为广告引导的审核结果信息
    DataId String 图片标识,审核结果会返回原始内容,长度限制为512字节。

    审核信息(PornInfo、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,可能为人物名字等)
    Category String 该字段为Label的子集,表示审核命中的具体审核类别。例如 Sexy,表示色情标签中的性感类别
    SubLabel String 该字段表示审核命中的具体子标签,例如:Porn 下的 SexBehavior 子标签。
    注意:该字段可能返回空,表示未命中具体的子标签
    OcrResults Container Array 该字段表示 OCR 文本识别的详细检测结果,包括文本识别结果、命中的关键词等信息,有相关违规内容时返回

    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>
          <JobId>xxxxxxxxxxxxxxx</JobId>
          <CompressionResult>0</CompressionResult>
          <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>

    目录