文档首页> 内容审核 Moderation> API参考> API> 视频审核> 查询视频内容审核作业
更新时间:2023-11-02 GMT+08:00
分享

查询视频内容审核作业

功能介绍

查询视频审核作业处理状态与结果,并将识别结果返回给用户。

调试

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

URI

GET /v3/{project_id}/moderation/video/jobs/{job_id}

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

项目ID。获取方法请参见获取项目ID

job_id

String

创建作业成功时,接口返回的job_id。

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

用户Token。 通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。

响应参数

状态码: 200

表3 响应Body参数

参数

参数类型

描述

request_id

String

本次请求的唯⼀标识,⽤于问题排查,建议保存。

job_id

String

作业id。

status

String

作业状态,可取值有:

  • running: 正在运行
  • succeeded: 运行成功
  • failed: 运行失败

request_params

request_params object

作业创建参数。

create_time

String

作业创建时间。

update_time

String

作业更新时间。

result

result object

作业审核结果,当作业状态为succeeded时存在。

表4 request_params

参数

参数类型

描述

data

data object

创建作业时传的data参数。

event_type

String

创建作业时传的event_type参数。

image_categories

Array of strings

创建作业时传的image_categories参数。

audio_categories

Array of strings

创建作业时传的audio_categories参数。

callback

String

创建作业时传的callback参数。

表5 data

参数

参数类型

描述

url

String

创建作业时传的url参数。

frame_interval

Integer

创建作业时传的frame_interval参数,默认为5秒截取一帧。

表6 result

参数

参数类型

描述

suggestion

String

视频审核结果是否通过。

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

image_detail

Array of image_detail objects

图像审核详情。

audio_detail

Array of audio_detail objects

音频审核详情。

表7 image_detail

参数

参数类型

描述

suggestion

String

图像审核结果是否通过。

  • block:包含敏感信息,不通过
  • review:需要人工复检

category

String

检测结果的一级标签。 支持category列表如下:

  • terrorism: 暴恐
  • porn: 色情
  • image_text: 图文审核

ocr_text

String

图文审核检测出的文本,只有在category参数配置image_text且检测出文本时展示该字段。

time

Float

截帧在视频文件中的时间,单位为秒。

detail

Array of detail objects

图像帧审核详情。

表8 detail

参数

参数类型

描述

confidence

Float

置信度,可选值在0-1之间,值越大,可信度越高。

category

String

检测结果的一级标签。 支持category列表如下:

  • terrorism: 暴恐
  • porn: 色情
  • image_text: 图文审核

suggestion

String

审核结果是否通过。

  • block:包含敏感信息,不通过
  • review:需要人工复检

label

String

识别的详细标签。

face_location

face_location object

人物位置信息。

qr_location

qr_location object

二维码位置信息。

qr_content

String

图片中二维码指向的链接,当请求参数categories中包含image_text时存在。

segments

Array of segments objects

image_text场景下命中的文本片段。

表9 face_location

参数

参数类型

描述

top_left_x

Integer

检测出人脸的左上角横坐标。

top_left_y

Integer

检测出人脸的左上角纵坐标。

bottom_right_x

Integer

检测出人脸的右下角横坐标。

bottom_right_y

Integer

检测出人脸的右下角纵坐标。

表10 qr_location

参数

参数类型

描述

top_left_x

Integer

检测出的二维码左上角横坐标。

top_left_y

Integer

检测出的二维码左上角纵坐标。

bottom_right_x

Integer

检测出的二维码右下角横坐标。

bottom_right_y

Integer

检测出的二维码右下角纵坐标。

表11 segments

参数

参数类型

描述

segment

String

命中的风险片段。

表12 audio_detail

参数

参数类型

描述

suggestion

String

音频片段审核结果是否通过。

  • block:包含敏感信息,不通过
  • review:需要人工复检

label

String

音频片段检测标签,选取detail中置信度最大的标签,可取值如下:

  • terrorism: 暴恐
  • porn: 色情
  • ad: 广告
  • ad_law: 广告法
  • abuse: 辱骂
  • ban: 违禁
  • meaningless: 无意义
  • moan: 娇喘

audio_text

String

音频片段文本内容。

end_time

Float

音频片段结束时间。

start_time

Float

音频片段开始时间。

detail

Array of detail objects

音频片段审核详情。

表13 detail

参数

参数类型

描述

confidence

Float

风险置信度。

label

String

风险标签。

suggestion

String

审核处理建议。

  • block:包含敏感信息,不通过
  • review:需要人工复检

segments

Array of segments objects

命中的风险片段信息列表,如果命中语义算法模型,则该字段不会存在。

表14 segments

参数

参数类型

描述

segment

String

命中的风险片段。

状态码: 400

表15 响应Body参数

参数

参数类型

描述

error_code

String

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

调用成功时无此字段。

error_msg

String

调用失败时的错误信息。

调用成功时无此字段。

请求示例

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

例如,服务部署在“华北-北京四”区域的“endpoint”“moderation.cn-north-4.myhuaweicloud.com”,请求URL为“https://moderation.cn-north-4.myhuaweicloud.com/v3/{project_id}/moderation/video/{job_id}”“project_id”为项目ID,获取方法请参见获取项目ID“job_id”为创建作业成功时,接口返回的job_id。

GET https://{endpoint}/v3/{project_id}/moderation/video/{job_id}

响应示例

状态码: 200

成功响应示例

{
  "request_id" : "xxxx",
  "job_id" : "xxx",
  "status" : "succeeded",
  "request_params" : {
    "data" : {
      "url" : "xxxx",
      "frame_interval" : 5
    },
    "event_type" : "default",
    "image_categories" : [ "porn",  "terrorism", "image_text" ],
    "audio_categories" : [ "porn", "ad",  "moan", "abuse" ],
    "callback" : "xxx"
  },
  "create_time" : "2022-07-30T08:57:11.011Z",
  "update_time" : "2022-07-30T08:57:14.014Z",
  "result" : {
    "suggestion" : "block",
    "image_detail" : [ {
      "suggestion" : "block",
      "category" : "porn",
      "ocr_text" : "123",
      "time" : 0,
      "detail" : [ {
        "confidence" : 0.676015138626099,
        "category" : "porn",
        "suggestion" : "block",
        "label" : "pornography"
      }, {
        "confidence" : 0.666015138626099,
        "category" : "porn",
        "suggestion" : "review",
        "label" : "sexy_female"
      }, {
        "confidence" : 0.666015138626099,
        "category" : "xxx",
        "suggestion" : "block",
        "label" : "leader"
      }, {
        "confidence" : 0.691423773765564,
        "category" : "xxx",
        "suggestion" : "block",
        "face_location" : {
          "top_left_x" : 12,
          "top_left_y" : 13,
          "bottom_right_x" : 200,
          "bottom_right_y" : 240
        },
        "label" : "leader"
      }, {
        "confidence" : 0.691423773765564,
        "category" : "porn",
        "suggestion" : "block",
        "face_location" : {
          "top_left_x" : 12,
          "top_left_y" : 13,
          "bottom_right_x" : 100,
          "bottom_right_y" : 2000
        },
        "label" : "leader"
      }, {
        "confidence" : 0.891423773765564,
        "category" : "image_text",
        "suggestion" : "block",
        "label" : "qr_code"
      }, {
        "confidence" : 0.891423773765564,
        "category" : "image_text",
        "suggestion" : "block",
        "label" : "qr_code",
        "qr_content" : "xxxxxxxxx",
        "qr_location" : {
          "top_left_x" : 12,
          "top_left_y" : 13,
          "bottom_right_x" : 100,
          "bottom_right_y" : 2000
        }
      }, {
        "confidence" : 0.891423773765564,
        "category" : "image_text",
        "suggestion" : "block",
        "label" : "porn",
        "segments" : [ {
          "segment" : "xxx"
        }, {
          "segment" : "xx"
        } ]
      } ]
    } ],
    "audio_detail" : [ {
      "suggestion" : "block",
      "label" : "porn",
      "audio_text" : "xxxxx",
      "end_time" : 10,
      "start_time" : 0,
      "detail" : [ {
        "confidence" : 0.999117187582349,
        "label" : "porn",
        "suggestion" : "block",
        "segments" : [ {
          "segment" : "xxx"
        } ]
      }, {
        "confidence" : 0.885117187582349,
        "label" : "porn",
        "suggestion" : "block"
      } ]
    } ]
  }
}

状态码: 400

失败响应示例

{
  "error_code" : "AIS.0030",
  "error_msg" : "Job not found"
}

状态码

状态码

描述

200

查询成功时返回作业状态和结果。

400

查询失败时返回错误原因。

分享:

    相关文档

    相关产品