4.3 短语音内容审核
4.3.1 语音内容审核
状态码: 400 失败响应示例
{ "error_code" : "AIS.0005",
"error_msg" : "The service does not exist."
}
状态码
状态码 描述
200 成功响应示例。
400 失败响应示例。
错误码
请参见错误码。
4.3 短语音内容审核
4.3.1 语音内容审核
功能介绍
分析并识别用户上传的语音内容是否有敏感内容(如色情、政治等),并将识别结果 返回给用户。
前提条件
● 在使用语音内容审核之前需要您完成服务申请和认证鉴权.
● 语音内容审核默认API调用最大并发为1,如需调整更高并发限制请联系华为专业 工程师为您服务。
调试
您可以在API Explorer中调试该接口。
URI
POST /v2/{project_id}/moderation/voice
表4-54 路径参数
参数 是否必选 参数类型 描述
project_id 是 String 用户项目id
请求参数
表4-55 请求 Body 参数
参数 是否必选 参数类型 描述
data 否 String 语音文件Base64编码字符串。要求 base64编码后大小不超过4M,语音时 长不超过1分钟。
说明参数data和url二选一。
url 否 String 语音的URL路径。
目前支持对服务授权访问华为云上OBS 的URL,华为云上OBS提供的临时授权 访问的URL和匿名公开授权的URL。
OBS服务的访问权限设置请参见配置 OBS访问权限。
出于安全的考虑,当前服务不支持从公 网上任意URL读取数据。
config 是 config
object 语音文件配置信息 categories 否 Array of
strings 检测场景。
当前支持的场景有默认场景和用户自定 义场景:
● 默认场景为:
– politics:涉政 – porn:涉黄 – ad:广告 – abuse:辱骂
– contraband:违禁品
● 用户自定义场景为:自定义黑名单词 库。
说明
● 自定义黑名单词库的名称指定给 categories就是设置自定义的场景,
表4-56 config
参数 是否必选 参数类型 描述
format 是 String 支持的语音格式。
枚举值:
● pcm16k16bit
● pcm8k16bit
● ulaw16k8bit
● ulaw8k8bit
● alaw16k8bit
● alaw8k8bit
● mp3
● aac
● wav
● amr
● amrwb
property 是 String 所使用的模型特征串。通常是“语种_采 样率_领 域”的形式。采样率需要与音 频采样率保持一致。当前支持如下模型 特征串: chinese_8k_common和 chinese_16k_common。
枚举值:
● chinese_8k_common
● chinese_16k_common
响应参数
状态码: 200
表4-57 响应 Body 参数
参数 参数类型 描述
result result object 调用成功时表示调用结果。调用失败时无此字 段。
suggestion String 检测结果是否通过。
● block:包含敏感信息,不通过。
● pass:不包含敏感信息,通过。
● review:需要人工复查。
表4-58 result
参数 参数类型 描述
detail detail object 审核结果列表,text为语音转文本后审核结果,
audio为音频审核结果。
表4-59 detail
参数 参数类型 描述
text Object 返回的语音转文本后审核结果详细信息:
●politics:涉政敏感词列表。
●porn:涉黄敏感词列表。
●ad:广告敏感词列表。
●abuse:辱骂敏感词列表。
●contraband:违禁品敏感词列表。
audio audio object 返回的音频审核结果列表,porn为涉黄场景审核 结果,当前仅支持porn场景。
表4-60 audio
参数 参数类型 描述
porn Array of PornModerat ionResultDet ail objects
涉黄场景审核结果。
表4-61 PornModerationResultDetail
参数 参数类型 描述
confidence Number 置信度,取值范围0-1。
label String 当前支持label列表如下:
● normal:正常
● porn:色情
状态码: 400
表4-62 响应 Body 参数
参数 参数类型 描述
error_code String 错误码。
最小长度:8 最大长度:36 error_msg String 错误描述。
最小长度:2 最大长度:512
请求示例
使用语音URL
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" : [ "politics", "ad" ]
"suggestion" : "pass"
}}
状态码: 400 失败响应示例
{ "error_code" : "AIS.0005",
状态码
状态码 描述
200 Demo Information 400 Error response
错误码
请参见错误码。