文档首页> 内容审核 Moderation> API参考> API> 音频审核> 查询音频内容审核作业
更新时间:2023-11-02 GMT+08:00
分享

查询音频内容审核作业

功能介绍

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

调试

您可以在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/{job_id}”“project_id”为项目ID,获取方法请参见获取项目ID“job_id”为创建作业成功时,接口返回的job_id。。

GET https://{endpoint}/v3/{project_id}/moderation/audio/{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

失败响应示例。

错误码

请参见错误码

分享:

    相关文档

    相关产品