请求参数#

请求url#

  • 北京:http://api-audio-bj.fengkongcloud.com/v2/saas/anti_fraud/audio
  • 上海:http://api-audio-sh.fengkongcloud.com/v2/saas/anti_fraud/audio

请求方法#

POST

字符编码#

UTF-8

建议超时时间#

1s

请求参数#

放在HTTP Body中,采用Json格式,具体参数如下:

参数名称类型是否必选说明
accessKeystringY公司密钥
用于权限认证,开通账号服务时由数美提供
typestringY需要识别的违规类型,可选值:
涉政识别:POLITICAL
国歌识别:ANTHEN
色情识别:PORN
广告识别:AD
娇喘识别:MOAN
性别识别:GENDER
场景识别(唱歌/无人声):SCENE
唱歌识别:SING
语种识别:LANGUAGE
识别音色标签:TIMBRE
需要同时传入GENDER才能生效
如需做组合识别,通过下划线连接即可,如 AD_PORN_POLITICAL 用于广告、色情和涉政识别
默认取值:DEFAULT等价于POLITICAL_PORN_MOAN
appIdstringN应用标识,用于区分相同公司的不同应用,该参数传递值可与数美服务协商用于区分应用
默认应用值:default
btIdstringY音频唯一标识
限长128位字符长度, 不能重复,否则提示参数错误
datajson_objectY请求数据,最长1MB,详细内容参见下表
callbackstringN异步检测结果回调通知您的URL,支持HTTP和HTTPS
字段为空时,您必须通过查询接口主动查询结果
callbackParamjson_objectN透传字段
当 callback 存在时可选,发送回调请求时服务将该字段内容同音频结果一起返回

data的内容如下:

参数名称类型是否必选说明
urlstringN待识别音频url地址,url和content至少提供一个
contentstringN待识别音频的base64编码数据
上限6M,仅支持pcm、wav、mp3
pcm格式数据必须采用16-bit小端序编码
推荐使用pcm、wav格式传输
url和content至少提供一个,同时存在时仅支持content
formatInfojson_objectN当content存在时必须存在
本地语音文件格式信息
json内具体格式见下方说明
audioNamestringN音频文件名称
tokenIdstringN用户账号标识
channelstringN数据场景,取值需要与数美协商
returnAllTextboolN可取值:
true:返回所有音频片段识别结果
每10秒一个音频片段
false:返回风险片段(riskLevel为REJECTREVIEW)识别结果
默认为false
nicknamestringN用户昵称
timestampintN时间戳(毫秒级)
roomstringN房间号

formatInfo内容如下:

参数名称类型是否必选说明
formatstringY语音数据格式
仅支持(取值)pcm、wav、mp3,严格小写
rateintN语音数据采样率
当语音数据格式为pcm时必须存在
范围限制8000-32000
trackintN语音数据声道数
当语音数据格式为pcm时必须存在,可取值:
单声道:1
双声道:2

请求示例#

上传url音频数据请求示例

{
"accessKey":"****************",
"type":"DEFAULT",
"appId":"default",
"btId":"test01",
"data":{
"tokenId":"test_01",
"url":"http://xxxxxxxx.mp3",
"channel":"IM_MESSAGE",
"returnAllText":true
},
"callback":"http://xxxxxxxxx",
"callbackParam":{
" param1":1,
" param2":"qew",
" param3":true
}
}

上传base64音频数据请求示例

{
"accessKey":"****************",
"type":"DEFAULT",
"appId":"default",
"btId":"test01",
"data":{
"content":"音频base64编码数据",
"formatInfo":{
"format":"pcm",
"rate":16000,
"track":1},
"channel":"IM_MESSAGE",
"tokenId":"asdwef",
"returnAllText":true
},
"callback":"http://xxxxxx",
"callbackParam":{
"param1":1,
"param2":"qew",
"param3":true}
}