语音内容审核（V2）
功能介绍
分析并识别上传的语音内容是否有敏感内容（如色情等），并将识别结果返回给您。
语音内容审核默认API调用最大并发为10，如需调整更高并发限制请联系华为专业工程师为您服务。
前提条件
在使用语音内容审核之前需要您完成服务申请和认证鉴权，具体操作流程请参见内容审核快速入门。
URI
POST /v2/{project_id}/moderation/voice
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
project_id |
是 |
String |
项目id。获取方法请参见获取项目ID。 |
请求参数
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
data |
否 |
String |
data和url二选一。 语音文件Base64编码字符串。要求base64编码后大小不超过4M，语音时长不超过1分钟。 |
url |
否 |
String |
data和url二选一。 该参数是指语音的URL路径。 目前支持对服务授权访问华为云上OBS的URL，华为云上OBS提供的临时授权访问的URL和匿名公开授权的URL。 OBS服务的访问权限设置请参见配置OBS访问权限。 出于安全的考虑，当前服务不支持从公网上任意URL读取数据。 |
config |
是 |
config object |
语音文件配置信息。 |
categories |
否 |
Array of strings |
检测场景。 当前支持的场景有默认场景和用户自定义场景：
|
响应参数
状态码： 200
参数 |
参数类型 |
描述 |
|---|---|---|
result |
result object |
调用成功时表示调用结果。调用失败时无此字段。 |
参数 |
参数类型 |
描述 |
|---|---|---|
detail |
detail object |
审核结果列表。
|
suggestion |
String |
检测结果是否通过。
|
参数 |
参数类型 |
描述 |
|---|---|---|
text |
Object |
返回的语音转文本后审核结果详细信息： ●porn：涉黄敏感词列表。 ●ad：广告敏感词列表。 ●abuse：辱骂敏感词列表。 ●contraband：违禁品敏感词列表。 |
audio |
audio object |
返回的音频审核结果列表。porn为涉黄场景审核结果，当前仅支持porn场景。 |
参数 |
参数类型 |
描述 |
|---|---|---|
confidence |
Number |
置信度，取值范围0-1。 |
label |
String |
每个检测结果的标签化说明。 当前支持label列表如下：
|
状态码： 400
参数 |
参数类型 |
描述 |
|---|---|---|
error_code |
String |
调用失败时的错误码，具体请参见错误码。 调用成功时无此字段。 |
error_msg |
String |
调用失败时的错误信息。 调用成功时无此字段。 |
请求示例
POST https://{endpoint}/v2/{project_id}/moderation/voice
{
"url" : "https://BucketName.obs.myhuaweicloud.com/audio/test.aac",
"config" : {
"format" : "aac",
"property" : "chinese_8k_common"
},
"categories" : ["ad" ]
}
响应示例
状态码： 200
成功响应示例
{
"result" : {
"detail" : {
"audio" : {
"porn" : [ {
"confidence" : 0.9999,
"label" : "normal"
}, {
"confidence" : 0.0001,
"label" : "porn"
} ]
},
"text" : {
"contraband" : [ "亚砷酸" ]
}
},
"suggestion" : "block"
}
}
状态码： 400
失败响应示例
{
"error_code" : "AIS.0005",
"error_msg" : "The service does not exist."
}
状态码
状态码 |
描述 |
|---|---|
200 |
成功响应示例。 |
400 |
失败响应示例。 |
错误码
请参见错误码。
