文档首页/ 内容审核 Moderation/ API参考/ API/ 图像审核/ 图像内容审核（异步批量）（V2）/ 处理结果查询
更新时间：2024-04-29 GMT+08:00
查看PDF
分享

处理结果查询

功能介绍

查询批量图片内容审核任务的结果，任务成功执行时会返回每张图片的详细审核结果，单张图片的失败，不会导致任务失败。

任务最长保留时间为30分钟，过期后会被清理掉。建议在任务提交后，每30s进行一次周期查询。

调试

您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。

URI

GET /v2/{project_id}/moderation/image/batch

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

项目ID。获取方法请参见获取项目ID。
表2 Query参数

参数

是否必选

参数类型

描述

job_id

是

String

任务标识。

请求参数

表3 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

是

String

用户Token。

用于获取操作API的权限。获取方法请参见获取Token接口，响应消息头中X-Subject-Token的值即为Token。

响应参数

状态码： 200

表4 响应Body参数

参数

参数类型

描述

result

CheckResultResultBody object

调用成功时表示调用结果。

调用失败时无此字段。
表5 CheckResultResultBody

参数

参数类型

描述

job_id

String

任务标识。

status

String

任务状态。

  • created：已创建
  • running：正在处理
  • finish：已完成
  • failed：处理失败

create_time

String

任务创建的时间。例如：2018-01-02T15:03:04Z

update_time

String

任务最近更新的时间。例如：2018-01-02T15:03:04Z

items

Array of CheckResultItemsBody objects

图片内容检测的结果列表。
表6 CheckResultItemsBody

参数

参数类型

描述

url

String

图片的URL路径。

suggestion

String

审核结果是否通过。

  • block：包含敏感信息，不通过
  • pass：不包含敏感信息，通过
  • review：需要人工复检
说明：
  1. 当同时检测多个场景时，suggestion的值以最可能包含敏感信息的场景为准。即任一场景出现了block则总的suggestion为block，所有场景都pass时suggestion为pass，这两种情况之外则一定有场景需要review，此时suggestion为review。
  2. 目前本服务不会保存客户的调用结果（如block的历史信息），因为涉及到客户的数据隐私问题，建议您保留接口调用结果的日志信息。

detail

ImageDetectionResultDetail object

针对选定的每个检测场景列出结果列表，terrorism为暴恐检测结果，porn为涉黄检测结果。如果检测场景中的最高置信度也未达到threshold则结果列表为空。

category_suggestions

Map<String,String>

具体每个场景的检测结果。

  • block：包含敏感信息，不通过
  • pass：不包含敏感信息，通过
  • review：需要人工复检

ocr_text

String

ocr识别结果。
表7 ImageDetectionResultDetail

参数

参数类型

描述

porn

Array of ImageDetectionResultSimpleDetail objects

涉黄检测结果。

terrorism

Array of ImageDetectionResultSimpleDetail objects

暴恐检测结果。

ad

Array of ImageDetectionResultAdDetail objects

广告检测结果。
表8 face_detail

参数

参数类型

描述

h

Integer

人脸区域高度。

w

Integer

人脸区域宽度。

x

Integer

人脸区域左上角到y轴距离。

y

Integer

人脸区域左上角到x轴距离。
表9 ImageDetectionResultSimpleDetail

参数

参数类型

描述

confidence

Float

置信度，取值范围 0-1。

label

String

每个检测结果的标签化说明：

terrorism：label为对应的暴恐元素信息。

  • 暴恐场景当前支持label列表如下：
    • normal：正常
    • knife：刀
    • gun：枪
    • fire：火灾
    • bloody ：血腥
    • terrorist：暴恐组织及标志
    • fascist：法西斯组织及标志
    • cult：邪教组织及标志
    • special_characters ：特殊文字
    • kidnap：绑架
    • corpse：尸体
    • riot：暴乱事件
    • parade ：游行示威
    • sensitive_landmarks：敏感地标
    • military_weapon：军事武器
    • army：警察部队
    • crowd：人群聚集

porn：label为对应的涉黄分类（涉黄、性感等）信息。

  • 鉴黄场景当前支持label列表如下：
    • normal：正常
    • porn：色情
    • sexy：性感

ad：label为对应的广告识别结果信息。

  • 广告场景当前支持label列表如下：
    • normal：正常
    • ad：广告
  • 图文审核场景当前支持label列表如下：
    • normal：正常
    • qr_code：二维码
    • porn：涉黄
    • ad：广告
    • abuse：辱骂
    • contraband：违禁品
    • 其他自定义黑名单词库名称
表10 ImageDetectionResultAdDetail

参数

参数类型

描述

confidence

Float

置信度，取值范围 0-1。

label

String

ad：label为对应的广告识别结果信息。

  • 广告场景当前支持label列表如下：
    • normal：正常
    • ad：广告
  • 图文审核场景当前支持label列表如下：
    • normal：正常
    • qr_code：二维码
    • porn：涉黄
    • ad：广告
    • abuse：辱骂
    • contraband：违禁品
    • 其他自定义黑名单词库名称

hit_contexts

Array of strings

图文审核场景命中的文本列表。

状态码： 400

表11 响应Body参数

参数

参数类型

描述

error_code

String

调用失败时的错误码，具体请参见错误码。

调用成功时无此字段。

error_msg

String

调用失败时的错误信息。

调用成功时无此字段。

fail_category

String

当包含多个场景时，调用失败的场景。

请求示例

“endpoint”即调用API的请求地址，不同服务不同区域的endpoint不同，具体请参见终端节点。

例如，服务部署在“华北-北京四”区域的“endpoint”为“moderation.cn-north-4.myhuaweicloud.com”，请求URL为“https://moderation.cn-north-4.myhuaweicloud.com/v2/{project_id}/moderation/image/batch?job_id={job_id}”，“project_id”为项目ID，获取方法请参见获取项目ID，“job_id”为接口返回的job_id

GET https://{endpoint}/v2/{project_id}/moderation/image/batch?job_id={job_id}

响应示例

状态码： 200

成功响应示例

{
  "result" : {
    "job_id" : "44d93b70-db01-4f96-a618-2a79c964c4b2",
    "status" : "finish",
    "create_time" : "2018-01-02T15:03:04Z",
    "update_time" : "2018-01-02T15:03:04Z",
    "items" : [ {
      "url" : "https://obs-test-llg.obs.myhuaweicloud.com/terrorism",
      "suggestion" : "pass",
      "detail" : {
        "terrorism" : [ {
          "confidence" : 0,
          "label" : "fire"
        }, {
          "confidence" : 0.0268,
          "label" : "normal"
        } ]
      }
    }, {
      "url" : "https://obs-test-llg.obs.myhuaweicloud.com/clarity-detect",
      "suggestion" : "pass",
      "detail" : {
        "terrorism" : [ {
          "confidence" : 0,
          "label" : "knife"
        }, {
          "confidence" : 0,
          "label" : "terrorist"
        }, {
          "confidence" : 0.3086,
          "label" : "bloody"
        }, {
          "confidence" : 0.6914,
          "label" : "normal"
        } ]
      },
      "ocr_text" : "fdfefdfdfdfd"
    } ]
  }
}

状态码： 400

失败响应示例

{
  "error_code" : "AIS.0005",
  "error_msg" : "The service does not exist."
}

状态码

状态码

描述

200

成功响应示例。

400

失败响应示例。

错误码

请参见错误码。

相关文档