# 创建视频内容审核作业 - Creating a Video Moderation Job
#### 功能介绍
创建视频内容审核作业，创建成功会将作业ID返回给用户。
#### 调试
您可以在[API Explorer](https://apiexplorer.developer.huaweicloud.com/apiexplorer/doc?product=Moderation&api=RunCreateVideoModerationJob&version=v3)中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。
#### URI
POST /v3/{project_id}/moderation/video/jobs
表1路径参数 
| 参数         | 是否必选 | 参数类型   | 描述                                                                                            |
|:---|:---|:---|:---|
| project_id | 是    | String | 项目ID。获取方法请参见[获取项目ID](https://support.huaweicloud.com/api-moderation/moderation_03_0055.html)。 |
   
#### 请求参数
表2请求Header参数 
| 参数           | 是否必选 | 参数类型   | 描述                                                        |
|:---|:---|:---|:---|
| X-Auth-Token | 是    | String | 用户Token。 通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 |
   
表3请求Body参数 
| 参数               | 是否必选 | 参数类型                                             | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
|:---|:---|:---|:---|
| data             | 是    | [data] object | 视频数据输入。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| event_type       | 否    | String                                           | 事件类型，可选值如下： - default：默认事件。  - group_message：群聊视频。  - message：私聊视频。  - live：秀场直播。  - dynamic：动态。                                                                                            |
| image_categories | 否    | Array of strings                                 | 视频中画面需要检测的风险类型，列表不能为空。 - terrorism：暴恐违规内容。  - porn：涉黄违规内容。  - politics：涉政违规内容。  - image_text：图文违规内容（检测图片中出现的广告、色情、暴恐、涉政的文字违规内容以及二维码内容）。                                                                                                                                        |
| audio_categories | 否    | Array of strings                                 | 视频中音频需要检测的风险类型，不传或为空时表示不审核音频维度。 - politics: 涉政违规内容。  - porn：涉黄违规内容。  - ad: 广告违规内容。  - moan: 娇喘违规内容。  - abuse: 辱骂违规内容。                                                                                   |
| callback         | 否    | String                                           | 该字段非空时，检测结果会回调通知您的URL。该字段为空时，您需要定时轮询获取检测结果。 说明： 1. 您的callback接口需要支持POST方法；  2. 回调数据格式，请参考[查询视频内容审核作业的响应示例](https://support.huaweicloud.com/api-moderation/moderation_03_0072.html#moderation_03_0072__section10668255121511)；  3. 您的服务端callback接口收到内容安全发送的结果后，如果在响应超时时间3秒内返回的HTTP状态码为200，则表示接收成功。其他HTTP状态码或响应时间大于3秒后返回状态码均视为接收失败，接收失败时，内容安全将重复发送多次检测结果。   |
| seed             | 否    | String                                           | 用于回调通知时校验请求是由华为云内容安全服务发起，您可以自定义。值为随机字符串，由英文字母、数字、下划线组成，不超过64个字符。 说明： 当seed非空时，headers中将包含X-Auth-Signature字段，字段的值使用HmacSHA256算法生成，待加密字符串由create_time、job_id、request_id、seed按照顺序拼接而成，密钥为seed。                                                                                                                                                                                                                                                                                                                                                                                                       |
   
 表4data 
| 参数             | 是否必选 | 参数类型    | 描述                                    |
|:---|:---|:---|:---|
| 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 | 调用失败时的错误码，具体请参见[错误码](https://support.huaweicloud.com/api-moderation/moderation_03_0010.html)。 调用成功时无此字段。 |
| error_msg  | String | 调用失败时的错误信息。 调用成功时无此字段。                                                                                     |
   
#### 请求示例
创建视频内容审核作业，事件类型为默认事件，检测的风险类型为涉黄，暴恐，图文违规内容检测。
![](https://support.huaweicloud.com/api-moderation/public_sys-resources/note_3.0-zh-cn.png)
"endpoint"即调用API的请求地址，不同服务不同区域的endpoint不同，具体请参见[终端节点](https://support.huaweicloud.com/api-moderation/moderation_03_0052.html)。
例如，服务部署在"华北-北京四"区域的"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](https://support.huaweicloud.com/api-moderation/moderation_03_0055.html)。
```
POST https://{endpoint}/v3/{project_id}/moderation/video/jobs
{
  "data" : {
    "url" : "https://xxxx",
    "frame_interval" : 5
  },
  "event_type" : "default",
  "image_categories" : [ "porn", "politics", "terrorism", "image_text" ],
  "audio_categories" : [ "porn", "ad", "politics", "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 | 返回失败响应体。 |