文档首页/ 内容审核 Moderation/ API参考/ API/ 音频审核/ 查询音频内容审核作业
更新时间：2024-08-05 GMT+08:00
查看PDF
分享

查询音频内容审核作业

功能介绍

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

调试

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

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: 暴恐
  • porn: 色情
  • ban: 违禁
  • abuse: 辱骂
  • ad: 广告
  • ad_law: 广告法
  • moan: 娇喘
  • meaningless: 无意义

audio_text

String

音频片段文本内容。

segments

Array of segments objects

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

参数

参数类型

描述

segment

String

命中的风险片段。
表7 request_params

参数

参数类型

描述

event_type

String

创建作业时传的event_type参数。

data

data object

创建作业时传的data参数。

callback

String

创建作业时传的callback参数。

categories

Array of strings

创建作业时传的categories参数。
表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

失败响应示例。

错误码

请参见错误码。

父主题： 音频审核

相关文档