腾讯云-语音技术
本接口用于对60秒之内的短音频文件进行识别,支持本地语音文件上传和语音URL上传两种请求方式。
当音频文件通过请求中body内容上传时,请求大小不能超过600KB;当音频以url方式传输时,音频时长不可超过60s。
所有请求参数放在POST请求的body中,编码类型采用x-www-form-urlencoded,参数进行urlencode编码后传输。
现暂只支持中文普通话和带有一定方言口音的中文普通话识别,支持识别8k16bit和16k16bit的mp3或者wav格式的单声道音频。
参数名称 | 类型 | 默认值 | 示例值 | 必须 | 描述 |
---|---|---|---|---|---|
EngSerViceType | String |
8k
|
是 | 引擎类型。8k:电话 8k 通用模型;16k:16k 通用模型。只支持单声道音频识别。 | |
SourceType | Number |
0
|
是 | 语音数据来源。0:语音 URL;1:语音数据(post body)。 | |
VoiceFormat | String |
wav
|
是 | 识别音频的音频格式(支持mp3,wav)。 | |
UsrAudioKey | String |
123213123
|
是 | 用户端对此任务的唯一标识,用户自助生成,用于用户查找识别结果。 | |
Url | String |
https://showapi.oss-cn-hangzhou.aliyuncs.com/modleapi/lzh/case13.wav
|
否 | 语音 URL,公网可下载。当 SourceType 值为 0(语音 URL上传) 时须填写该字段,为 1 时不填;URL 的长度大于 0,小于 2048,需进行urlencode编码。音频时间长度要小于60s。 | |
Data | String | 否 | 语音数据,当SourceType 值为1(本地语音数据上传)时必须填写,当SourceType 值为0(语音 URL上传)可不写。要使用base64编码(采用python语言时注意读取文件应该为string而不是byte,以byte格式读取后要decode()。编码后的数据不可带有回车换行符)。音频数据要小于600KB。 | ||
DataLen | Number | 否 | 数据长度,单位为字节。当 SourceType 值为1(本地语音数据上传)时必须填写,当 SourceType 值为0(语音 URL上传)可不写(此数据长度为数据未进行base64编码时的数据长度)。 | ||
ds_id | String | 是 | 数据源 |
参数名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
Response | Object | ||
- RequestId | String |
a0dcd6ec-60b4-43fe-8dd5-656f51b9532d
|
唯一请求 ID,每次请求都会返回。定位问题时需要提供该次请求的 RequestId。 |
- Result | String |
这样为了更好的帮助您请说下合适的回电时间,我们会安排在后专家给您回电。
|
识别结果。 |
remark | String |
查询成功!
|
|
ret_code | Number |
0
|
{
"showapi_res_error": "",
"showapi_res_id": "ed76a99458fd4056a9256e6d681ee319",
"showapi_res_code": 0,
"showapi_res_body": {
"Response": {
"RequestId": "a0dcd6ec-60b4-43fe-8dd5-656f51b9532d",
"Result": "这样为了更好的帮助您请说下合适的回电时间,我们会安排在后专家给您回电。"
},
"remark": "查询成功!",
"ret_code": 0
}
}
参数名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
showapi_res_body | String | {"city":"昆明","prov":"云南"} | 消息体的JSON封装,所有应用级的返回参数将嵌入此对象 。 |
showapi_res_code | int | 0 | 查看错误码 |
showapi_res_error | String | 用户输入有误! | 错误信息的展示 |
showapi_res_id | String | ce135f6739294c63be0c021b76b6fbff | 本次请求id |
状态码 | 描述 |
---|---|
0 | 成功 |
-1 | 系统调用错误 |
-2 | 可调用次数或金额为0 |
-3 | 读取超时 |
-4 | 服务端返回数据解析错误 |
-5 | 后端服务器DNS解析错误 |
-6 | 服务不存在或未上线 |
-7 | API创建者的网关资源不足 |
-3 | 读取超时 |
-1000 | 系统维护 |
-1002 | showapi_appid字段必传 |
-1003 | showapi_sign字段必传 |
-1004 | 签名sign验证有误 |
-1005 | showapi_timestamp无效 |
-1006 | app无权限调用接口 |
-1007 | 没有订购套餐 |
-1008 | 服务商关闭对您的调用权限 |
-1009 | 调用频率受限 |
-1010 | 找不到您的应用 |
-1011 | 子授权app_child_id无效 |
-1012 | 子授权已过期或失效 |
-1013 | 子授权ip受限 |
-1014 | token权限无效 |