查询接口

查询音频的审核结果。

查询说明

用于客户主动查询音频识别结果，支持近三天结果的查询。

接口要求

通信协议：http或https协议 请求方法：POST方法 字符编码：utf-8 参数格式：所有请求参数和返回参数都是采用json格式

审核时间

建议超时时间：同步请求接口建议设置5秒。 内部检测逻辑：音频检测接口的响应时间依赖音频的下载时间，请保证被检测音频所在的存储服务稳定可靠。具体时长和请求type、音频大小相关。

请求

请求地址

集群	请求地址	支持产品列表
上海	http://api-audio-sh.fengkongcloud.com/query_audio/v4	中文、阿拉伯语
硅谷	http://api-audio-sh.fengkongcloud.com/query_audio/v4	中文、英文、阿拉伯语
新加坡	http://api-audio-xjp.fengkongcloud.com/query_audio/v4	中文、英文、阿拉伯语

请求参数

参数名称	类型	参数说明	是否必传	规范
accessKey	string	公司密钥	是	由数美提供，具体内容见邮件
btId	string	音频文件唯一标识	是	唯一标识这条音频文件，用于查询识别结果

响应

返回参数

参数名称	类型	参数说明	是否必返	规范
requestId	string	本次请求的唯一标识	是
btId	string	音频唯一标识	是
code	int	请求返回码	是	1100：成功 1101：正在处理中 1901：QPS超限 1902：参数不合法 1903：服务失败 1904：下载失败 1905：解码失败 9100：余额不足 9101：无权限操作 除message和requestId之外的字段，只有当code为1100时才会存在
message	string	请求返回描述，和请求返回码对应	是
riskLevel	string	当前事件的处置建议	是	可能返回值： PASS：通过 REVIEW：审核 REJECT：拒绝 建议：对接初期不直接使用结果，进行拦截尺度调优，符合预期后在进行使用
audioText	string	整段音频转译文本结果	是
audioTime	int	整段音频的音频时长	是	单位秒
audioDetail	json_array	音频片段信息	是	回调的音频片段信息
audioStarttime	float	音频片段起始时间	是	相对音频开始的时间距离，单位是秒
audioEndtime	float	音频片段结束时间	是	相对音频开始的时间距离，单位是秒
audioUrl	string	音频片段链接	是	mp3格式
riskLevel	string	音频片段识别结果	是	可能返回值： PASS：通过 REVIEW：审核 REJECT：拒绝
businessLabels	json_array	业务标签返回	否	全部业务标签
businessLabel1	string	一级标签	是	一级标签
businessLabel2	string	二级标签	是	二级标签
businessLabel3	string	三级标签	是	三级标签
businessDescription	string	标签描述	是	格式为"一级标签:二级标签:三级标签"的中文名称
confidenceLevel	int	置信等级	否	可选值在0～2之间，值越大，可信度越高
probability	float	置信度	否	可选值为0~1，值越大，可信度越高
businessDetail	json_object	详细信息	否	保留字段
allLabels	json_array	风险标签返回	否	全部风险标签
riskLabel1	string	一级风险标签	是	一级风险标签
riskLabel2	string	二级风险标签	是	二级风险标签
riskLabel3	string	三级风险标签	是	三级风险标签
riskDescription	string	风险原因	是	风险原因，仅供人了解风险原因时作为参考，程序请勿依赖该参数的值做逻辑处理
riskLevel	string	处置建议	是	可能返回值： PASS：通过REVIEW：审核REJECT：拒绝
probability	float	置信度	否	可选值在0～1之间，值越大，风险可能性越高，值越小，无风险可能性越高
riskDetail	json_object	风险详情	否
audioText	string	音频转译文本的结果	否
matchedLists	json_array	命中的客户自定义名单信息	否	命中客户自定义名单时返回
name	string	客户自定义名单名称	是
words	json_array	命中的这个名单中的敏感词信息	是
word	string	敏感词	是
position	int_array	敏感词所在位置	是
riskSegments	json_array	高风险内容片段	否	在涉政、暴恐、违禁、竞品、广告法等功能的时候存在
segment	string	高风险内容片段	否
position	int_array	高风险内容片段所在位置	否
riskLabel1	string	一级风险标签	是
riskLabel2	string	二级风险标签	是
riskLabel3	string	三级风险标签	是
riskDescription	string	风险原因	是	仅供人了解风险原因时作为参考，程序请勿依赖该参数的值做逻辑处理
riskDetail	json_object	风险详情	否
audioText	string	音频转译文本的结果	否
matchedLists	json_array	命中的客户自定义名单信息	否	命中客户自定义名单时返回
name	string	客户自定义名单名称	是
words	json_array	命中的这个名单中的敏感词信息	是
word	string	敏感词	是
position	int_array	敏感词所在位置	是
riskSegments	json_array	高风险内容片段	否	在涉政、暴恐、违禁、竞品、广告法等功能的时候存在
segment	string	高风险内容片段	否
position	int_array	高风险内容片段所在位置	否
audioTags	json_object	音频标签	否	返回性别、音色、是否唱歌等标签。历史兼容字段，建议直接使用businessLabels
gender	string	性别	否	可能返回值： MALE：男性 FEMALE：女性 UNKNOWN：未知
label	string	性别标签名称	是	可能取值：男性 女性
probability	int	对应性别可能性大小	否	取值0-100，数值越高表示概率越大
timbre	string	音色	否	可能返回值： SILENT：静音 SOFT：柔和 LOUD：大声 UNKNOWN：未知
probability	int	对应音色标签可能性大小	否	取值0-100，数值越高表示概率越大
label	string	音色标签类别	否	可能取值： 大叔 青年 正太 老年 女王 御姐 少女 萝莉 大妈 男性 女性 无人声
language	json	语种	否
label	int	语种识别类别标识	是	可能取值： 0:普通话 1:英语 2:粤语 3:藏语 4:维语 5:蒙语 6:朝鲜语 -1:其他语种
probability	int	对应音色标签可能性大小	是	取值0-100，数值越高表示概率越大
requestParams	json_object	透传字段	是	返回data下所有字段
auxInfo	json_object	辅助信息	否
errorCode	int	状态码	是	状态码 2003：音频下载失败 2007：无有效数据

示例

请求示例

{

"accessKey": "*************",

"btId": "*************"

}

查询返回示例

{

"requestId": "6a9cb980346dfea41111656a514e9109",

"btId": "1604311839040",

"code": 1100,

"message": "正常",

"riskLevel": "PASS",

"audioDetail": [

{

"requestId": "6a9cb980346dfea41111656a514e9109_a0000",

"audioStarttime": 0,

"audioEndtime": 10,

"audioUrl": "https://voice-bj-1251671073.cos.ap-beijing.myqcloud.com/20201102/6a9cb980346dfea41111656a514e9109_a0000.mp3",

"businessLabels": [

{

"businessDescription": "唱歌:唱歌:唱歌",

"businessLabel1": "sing",

"businessLabel2": "changge",

"businessLabel3": "changge",

"confidenceLevel": 2,

"probability": 0.858334402569294

}

],

"allLabels": [],

"riskLevel": "PASS",

"riskLabel1": "normal",

"riskLabel2": "",

"riskLabel3": "",

"riskDescription": "正常",

"riskDetail": {

"audioText": ""

}

},

{

"requestId": "6a9cb980346dfea41111656a514e9109_a0001",

"audioStarttime": 10,

"audioEndtime": 20,

"audioUrl": "https://voice-bj-1251671073.cos.ap-beijing.myqcloud.com/20201102/6a9cb980346dfea41111656a514e9109_a0001.mp3",

"riskLevel": "PASS",

"riskLabel1": "normal",

"riskLabel2": "",

"riskLabel3": "",

"riskDescription": "正常",

"riskDetail": {

"audioText": ""

}

},

{

"requestId": "6a9cb980346dfea41111656a514e9109_a0002",

"audioStarttime": 20,

"audioEndtime": 30,

"audioUrl": "https://voice-bj-1251671073.cos.ap-beijing.myqcloud.com/20201102/6a9cb980346dfea41111656a514e9109_a0002.mp3",

"riskLevel": "PASS",

"riskLabel1": "normal",

"riskLabel2": "",

"riskLabel3": "",

"riskDescription": "正常",

"riskDetail": {

"audioText": ""

}

},

{

"requestId": "6a9cb980346dfea41111656a514e9109_a0003",

"audioStarttime": 30,

"audioEndtime": 40,

"audioUrl": "https://voice-bj-1251671073.cos.ap-beijing.myqcloud.com/20201102/6a9cb980346dfea41111656a514e9109_a0003.mp3",

"riskLevel": "PASS",

"riskLabel1": "normal",

"riskLabel2": "",

"riskLabel3": "",

"riskDescription": "正常",

"riskDetail": {

"audioText": ""

}

},

{

"requestId": "6a9cb980346dfea41111656a514e9109_a0004",

"audioStarttime": 40,

"audioEndtime": 50,

"audioUrl": "https://voice-bj-1251671073.cos.ap-beijing.myqcloud.com/20201102/6a9cb980346dfea41111656a514e9109_a0004.mp3",

"riskLevel": "PASS",

"riskLabel1": "normal",

"riskLabel2": "",

"riskLabel3": "",

"riskDescription": "正常",

"riskDetail": {

"audioText": ""

}

},

{

"requestId": "6a9cb980346dfea41111656a514e9109_a0005",

"audioStarttime": 50,

"audioEndtime": 60,

"audioUrl": "https://voice-bj-1251671073.cos.ap-beijing.myqcloud.com/20201102/6a9cb980346dfea41111656a514e9109_a0005.mp3",

"riskLevel": "PASS",

"riskLabel1": "normal",

"riskLabel2": "",

"riskLabel3": "",

"riskDescription": "正常",

"riskDetail": {

"audioText": ""

}

},

{

"requestId": "6a9cb980346dfea41111656a514e9109_a0006",

"audioStarttime": 60,

"audioEndtime": 60,

"audioUrl": "https://voice-bj-1251671073.cos.ap-beijing.myqcloud.com/20201102/6a9cb980346dfea41111656a514e9109_a0006.mp3",

"riskLevel": "PASS",

"riskLabel1": "normal",

"riskLabel2": "",

"riskLabel3": "",

"riskDescription": "正常"

}

],

"audioTags": {

"gender": {

"label": "女性",

"probability": 95

},

"language": [

{

"confidence": 0,

"label": 2

},

{

"confidence": 99,

"label": 0

},

{

"confidence": 0,

"label": 1

}

],

"song": 0,

"timbre": [

{

"label": "女性",

"probability": 95

},

{

"label": "女王",

"probability": 12

},

{

"label": "御姐",

"probability": 37

},

{

"label": "少女",

"probability": 56

},

{

"label": "大妈",

"probability": 67

},

{

"label": "萝莉",

"probability": 24

}

]

}

}