文档首页> 内容审核 Moderation> API参考> API> 视频审核> 创建视频内容审核作业
更新时间:2024-03-01 GMT+08:00
分享

创建视频内容审核作业

功能介绍

创建视频内容审核作业,创建成功会将作业ID返回给用户。

调试

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

URI

POST /v3/{project_id}/moderation/video/jobs

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

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

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

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

表3 请求Body参数

参数

是否必选

参数类型

描述

data

data object

视频数据输入。

biz_type

String

用户在控制台界面创建的自定义审核策略名称。

  • 如果请求参数中传了biz_type则优先使用biz_type。
  • 如果用户没传biz_type则event_type,image_categories必须传。

event_type

String

事件类型,可选值为 default表示默认事件。

image_categories

Array of strings

视频中画面需要检测的风险类型,列表不能为空。

  • terrorism:暴恐内容的检测
  • porn:鉴黄内容的检测
  • image_text:图文违规内容的检测(检测图片中出现的广告、色情、暴恐的文字违规内容以及二维码内容)

audio_categories

Array of strings

视频中音频需要检测的风险类型,不传或为空时表示不审核音频维度。

  • porn:涉黄检测
  • ad: 广告检测
  • moan: 娇喘检测
  • abuse: 辱骂检测

callback

String

回调http接口。当该字段非空时,服务将根据该字段回调通知用户审核结果。

表4 data

参数

是否必选

参数类型

描述

url

String

视频url地址。

frame_interval

Integer

截帧频率间隔,单位为秒,取值范围为1~60s。如果不传递默认5s截帧一次

language

String

支持的语言,当前只支持zh:中文,默认取值为zh。

响应参数

状态码: 200

表5 响应Body参数

参数

参数类型

描述

request_id

String

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

job_id

String

作业唯一标识。

状态码: 400

表6 响应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/jobs”“project_id”为项目ID,获取方法请参见获取项目ID

POST https://{endpoint}/v3/{project_id}/moderation/video/jobs
{
  "data" : {
    "url" : "https://xxxx",
    "frame_interval" : 5
  },
  "event_type" : "default",
  "image_categories" : [ "porn","terrorism", "image_text" ],
  "audio_categories" : [ "porn", "ad", "moan", "abuse" ],
  "callback" : "http://xxxx"
}

响应示例

状态码: 200

成功响应示例

{
  "job_id" : "01661356800_7c0fe871f80543358917e4faebca4a48",
  "request_id" : "07490f57ac5e034c077ab25b5f9e1da5"
}

状态码: 400

失败响应示例

{
  "error_code" : "AIS.0401",
  "error_msg" : "The input parameter event_type is incorrect."
}

状态码

状态码

描述

200

返回成功响应体。

400

返回失败响应体。

分享:

    相关文档

    相关产品