# 查询音频内容审核作业 - Querying an Audio Moderation Job #### 功能介绍 查询音频审核作业处理状态与结果，并将识别结果返回给用户。 #### 调试 您可以在[API Explorer](https://apiexplorer.developer.huaweicloud.com/apiexplorer/doc?product=Moderation&api=RunQueryAudioModerationJob&version=v3)中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。 #### URI GET /v3/{project_id}/moderation/audio/jobs/{job_id} 表1路径参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | project_id | 是 | String | 项目ID。获取方法请参见[获取项目ID](https://support.huaweicloud.com/api-moderation/moderation_03_0055.html)。 | | job_id | 是 | String | 创建作业成功时，接口返回的job_id。 | #### 请求参数 表2请求Header参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | X-Auth-Token | 是 | String | 用户Token。 通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 | #### 响应参数 **状态码： 200** 表3响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | job_id | String | 作业id。 | | status | String | 作业状态，可取值有： - running: 正在运行 - succeeded: 运行成功 - failed: 运行失败 | | result | [result] object | 作业审核结果，当作业状态为succeeded时存在。 | | request_params | [request_params] object | 作业创建参数。 | | create_time | String | 作业创建时间。 | | update_time | String | 作业更新时间。 | | request_id | String | 本次请求的唯一标识，用于问题排查，建议保存。 最小长度：2 最大长度：64 | 表4result | 参数 | 参数类型 | 描述 | |:---|:---|:---| | suggestion | String | 音频审核结果是否通过。 - block：包含敏感信息，不通过 - pass：不包含敏感信息，通过 - review：需要人工复检 | | details | Array of [details] objects | 审核详情。 | | audio_text | String | 音频文本内容。 | 表5details | 参数 | 参数类型 | 描述 | |:---|:---|:---| | start_time | Float | 音频片段开始时间。 | | suggestion | String | 音频片段审核处理建议。 - block：包含敏感信息，不通过 - review：需要人工复检 | | end_time | Float | 音频片段结束时间。 | | label | String | 音频片段标签。可选值如下： - terrorism: 暴恐违规内容。 - politics: 涉政违规内容。 - porn: 色情违规内容。 - ban: 违禁违规内容。 - abuse: 辱骂违规内容。 - ad: 广告违规内容。 - moan: 娇喘违规内容。 - meaningless: 无意义违规内容。 | | audio_text | String | 音频片段文本内容。 | | segments | Array of [segments] objects | 命中的风险片段信息列表，如果命中语义算法模型，则该字段不会存在。 | 表6segments | 参数 | 参数类型 | 描述 | |:---|:---|:---| | segment | String | 命中的风险片段。 | 表7request_params | 参数 | 参数类型 | 描述 | |:---|:---|:---| | event_type | String | 创建作业时传的event_type参数。 事件类型，枚举值如下： - default：默认事件 - audiobook：有声书 - education：教育音频 - game：游戏语音房 - live：秀场直播 - ecommerce：电商直播 - voiceroom：交友语音房 - private：私密语音聊天 | | data | [data] object | 创建作业时传的data参数。 | | callback | String | 创建作业时传的callback参数。 | | categories | Array of strings | 创建作业时传的categories参数。 风险类型如下： - politics：涉政违规内容。 - porn：涉黄违规内容。 - ad：广告违规内容。 - moan：娇喘违规内容。 - abuse：辱骂违规内容。 | 表8data | 参数 | 参数类型 | 描述 | |:---|:---|:---| | url | String | 创建作业时传的url参数。 | **状态码： 400** 表9响应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/{job_id}"，"project_id"为项目ID，获取方法请参见[获取项目ID](https://support.huaweicloud.com/api-moderation/moderation_03_0055.html)，"job_id"为创建作业成功时，接口返回的job_id。 ``` GET https://{endpoint}/v3/{project_id}/moderation/audio/jobs/{job_id} ``` #### 响应示例 **状态码： 200** 查询成功时返回作业状态和结果 ``` { "job_id" : "01655654400_ad96b30f58cc40e8968e53f1f1e80021", "status" : "succeeded", "result" : { "suggestion" : "block", "details" : [ { "start_time" : 0, "suggestion" : "block", "end_time" : 10, "label" : "porn", "audio_text" : "xxxx", "segments" : [ { "segment" : "xxx" }, { "segment" : "xxx" }, { "segment" : "xxx" } ] }, { "start_time" : 30, "suggestion" : "block", "end_time" : 40, "label" : "porn", "audio_text" : "xxx", "segments" : [ { "segment" : "xx" } ] } ], "audio_text" : "xxxxxx" }, "request_params" : { "event_type" : "default", "data" : { "url" : "https://xxxx.wav" }, "callback" : "http://xxx", "categories" : [ "porn", "ad" ] }, "create_time" : "2022-06-20 11:05:29", "update_time" : "2022-06-20 11:07:08", "request_id" : "2419446b1fe14203f64e4018d12db3dd" } ``` **状态码： 400** 查询失败时返回错误原因 ``` { "error_code" : "AIS.0030", "error_msg" : "Job not found" } ``` #### 状态码 | 状态码 | 描述 | |:---|:---| | 200 | 成功响应示例。 | | 400 | 失败响应示例。 | #### 错误码 请参见[错误码](https://support.huaweicloud.com/api-moderation/moderation_03_0010.html)。