# 创建音频内容审核作业 - Creating an Audio Moderation Job #### 功能介绍 创建音频内容审核作业，创建成功会将作业ID返回给用户。 #### 调试 您可以在[API Explorer](https://apiexplorer.developer.huaweicloud.com/apiexplorer/doc?product=Moderation&api=RunCreateAudioModerationJob&version=v3)中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。 #### URI POST /v3/{project_id}/moderation/audio/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 | 是 | [AudioInputBody] object | 音频数据输入。 | | event_type | 否 | String | 事件类型，可选值如下： - default：默认事件 - audiobook：有声书 - education：教育音频 - game：游戏语音房 - live：秀场直播 - ecommerce：电商直播 - voiceroom：交友语音房 - private：私密语音聊天 | | categories | 否 | Array of strings | 需要检测的风险类型，列表不能为空。 风险类型如下： - politics：涉政违规内容。 - porn：涉黄违规内容。 - ad：广告违规内容。 - moan：娇喘违规内容。 - abuse：辱骂违规内容。 | | callback | 否 | String | 该字段非空时，检测结果会回调通知您的URL。该字段为空时，您需要定时轮询获取检测结果。 说明： 1. 您的callback接口需要支持POST方法； 2. 回调数据格式，请参考[查询音频内容审核作业的响应示例](https://support.huaweicloud.com/api-moderation/moderation_03_0083.html#moderation_03_0083__section425352232512)； 3. 您的服务端callback接口收到内容安全发送的结果后，如果在响应超时时间3秒内返回的HTTP状态码为200，则表示接收成功。其他HTTP状态码或响应时间大于3秒后返回状态码均视为接收失败，接收失败时，内容安全将重复发送多次检测结果。 | | seed | 否 | String | 用于回调通知时校验请求是由华为云内容安全服务发起，您可以自定义。值为随机字符串，由英文字母、数字、下划线组成，不超过64个字符。 说明： 当seed非空时，headers中将包含X-Auth-Signature字段，字段的值使用HmacSHA256算法生成，待加密字符串由create_time、job_id、request_id、seed按照顺序拼接而成，密钥为seed。 | 表4AudioInputBody | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | url | 是 | String | 音频url地址。 | | language | 否 | String | 支持检测的音频语言。可选值为zh：中文。 不传该参数表示默认为zh。 | #### 响应参数 **状态码： 200** 表5响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | request_id | String | 本次请求的唯一标识，用于问题排查，建议保存。 最小长度：2 最大长度：64 | | 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/audio/jobs"，"project_id"为项目ID，获取方法请参见[获取项目ID](https://support.huaweicloud.com/api-moderation/moderation_03_0055.html)。 创建音频内容审核作业，事件类型为默认事件，检测的风险类型为涉黄，广告。 ``` POST https://{endpoint}/v3/{project_id}/moderation/audio/jobs { "data" : { "url" : "https://xxxxx.wav" }, "event_type" : "default", "categories" : [ "porn", "ad" ], "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 | 失败响应示例。 | #### 错误码 请参见[错误码](https://support.huaweicloud.com/api-moderation/moderation_03_0010.html)。