创建音频流内容审核作业
功能介绍
创建音频流内容审核作业,创建成功会将作业ID返回给用户。
- 创建审核作业后,建议您记录每个url对应的job_id,方便后续关闭该审核作业。
- 如果创建审核作业后,没有回调预期的审核结果,可能是因为流不稳定导致服务侧拉流失败。您可以关闭该审核作业,然后对该流重新创建审核作业。
URI
POST /v3/{project_id}/moderation/audio-stream/jobs
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
project_id |
是 |
String |
项目ID。获取方法请参见获取项目ID。 |
请求参数
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
X-Auth-Token |
是 |
String |
用户Token。 通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。 |
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
data |
是 |
data object |
音频流数据输入。 |
event_type |
是 |
String |
事件类型,可选值如下:
|
categories |
是 |
Array of strings |
需要检测的风险类型,列表不能为空。可选择的风险类型如下:
|
callback |
是 |
String |
该字段非空时,检测结果会回调通知您的URL。音频流未结束时,检测片段违规时回调客户端,音频流结束时,检测片段违规或正常都将回调客户端。
说明:
|
seed |
否 |
String |
用于回调通知时校验请求是由华为云内容安全服务发起,您可以自定义。值为随机字符串,由英文字母、数字、下划线组成,不超过64个字符。
说明:
当seed非空时,headers中将包含X-Auth-Signature字段,字段的值使用HmacSHA256算法生成,待加密字符串由create_time、job_id、request_id、seed按照顺序拼接而成,密钥为seed。 |
响应参数
状态码: 200
参数 |
参数类型 |
描述 |
---|---|---|
request_id |
String |
本次请求的唯一标识,用于问题排查,建议保存。 |
job_id |
String |
作业唯一标识。 |
状态码: 400
参数 |
参数类型 |
描述 |
---|---|---|
error_code |
String |
调用失败时的错误码,具体请参见错误码。 调用成功时无此字段。 |
error_msg |
String |
调用失败时的错误信息。 调用成功时无此字段。 |
请求示例
创建音频流内容审核作业请求体
POST https://{endpoint}/v3/{project_id}/moderation/audio-stream/jobs { "data" : { "url" : "https://xxxxx" }, "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 |
失败响应示例。 |
错误码
请参见错误码。