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

创建音频内容审核作业

功能介绍

创建音频内容审核作业，创建成功会将作业ID返回给用户。

URI

POST /v3/{project_id}/moderation/audio/jobs

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

项目ID。获取方法请参见获取项目ID。

请求参数

表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

需要检测的风险类型，列表不能为空。

风险类型如下：

  • porn：涉黄检测
  • ad：广告检测
  • moan：娇喘检测
  • abuse：辱骂检测

callback

否

String

该字段非空时，检测结果会回调通知您的URL。该字段为空时，您需要定时轮询获取检测结果。

说明：
  1. 您的callback接口需要支持POST方法；
  2. 回调数据格式，请参考查询音频内容审核作业的响应示例；
  3. 您的服务端callback接口收到内容安全发送的结果后，如果在响应超时时间3秒内返回的HTTP状态码为200，则表示接收成功。其他HTTP状态码或响应时间大于3秒后返回状态码均视为接收失败，接收失败时，内容安全将重复发送多次检测结果。

biz_type

否

String

用户在控制台界面创建的自定义审核策略名称。

  • 如果请求参数中传了biz_type则优先使用biz_type，event_type和categories参数将不生效，审核策略由biz_type的设置决定。
  • 如果用户没传biz_type则event_type和categories必须传。
说明：

“亚太-新加坡”站目前不支持此参数。

seed

否

String

用于回调通知时校验请求是由华为云内容安全服务发起，您可以自定义。值为随机字符串，由英文字母、数字、下划线组成，不超过64个字符。

说明：

当seed非空时，headers中将包含X-Auth-Signature字段，字段的值使用HmacSHA256算法生成，待加密字符串由create_time、job_id、request_id、seed按照顺序拼接而成，密钥为seed。
表4 AudioInputBody

参数

是否必选

参数类型

描述

url

是

String

音频url地址。

language

否

String

支持检测的音频语言。可选值如下：

  • zh：中文（默认值）
  • en：英文
  • ar：阿拉伯语

响应参数

状态码： 200

表5 响应Body参数

参数

参数类型

描述

request_id

String

本次请求的唯一标识，用于问题排查，建议保存。

最小长度：2

最大长度：64

job_id

String

作业唯一标识。

状态码： 400

表6 响应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”，“project_id”为项目ID，获取方法请参见获取项目ID。

创建音频内容审核作业，事件类型为默认事件，检测的风险类型为涉黄，广告。

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

失败响应示例。

错误码

请参见错误码。

父主题： 音频审核