文档首页/内容审核 Moderation/API参考/API/音频审核/查询音频内容审核作业 - Querying an Audio Moderation Job
更新时间：2025-11-26 GMT+08:00
查看PDF
分享

查询音频内容审核作业 - Querying an Audio Moderation Job

功能介绍

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

URI

GET /v3/{project_id}/moderation/audio/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参数

参数

参数类型

描述

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

表4 result

参数

参数类型

描述

suggestion

String

音频审核结果是否通过。

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

details

Array of details objects

审核详情。

audio_text

String

音频文本内容。

表5 details

参数

参数类型

描述

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

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

表6 segments

参数

参数类型

描述

segment

String

命中的风险片段。

表7 request_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：辱骂违规内容。
表8 data

参数

参数类型

描述

url

String

创建作业时传的url参数。

状态码： 400

表9 响应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/audio/jobs/{job_id}”，“project_id”为项目ID，获取方法请参见获取项目ID，“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

失败响应示例。

错误码

请参见错误码。

父主题：音频审核