语音识别
腾讯云-语音技术
语音识别（Automatic Speech Recognition，ASR）为开发者提供语音转文字服务的最佳体验，开放实时语音识别、一句话识别和录音文件识别三种服务形式，满足不同类型开发者需求，具备识别准确率高、接入便捷、性能稳定等特点。
会员资源包统一计费
暂未统计
累计调用
接入点说明:
本接口用于对60秒之内的短音频文件进行识别，支持本地语音文件上传和语音URL上传两种请求方式。
当音频文件通过请求中body内容上传时，请求大小不能超过600KB；当音频以url方式传输时，音频时长不可超过60s。
所有请求参数放在POST请求的body中，编码类型采用x-www-form-urlencoded，参数进行urlencode编码后传输。
现暂只支持中文普通话和带有一定方言口音的中文普通话识别，支持识别8k16bit和16k16bit的mp3或者wav格式的单声道音频。接口地址:
http[s]://route.showapi.com/1978-1?showapi_appid=替换自己的值&showapi_sign=替换自己的值
查看密钥
返回格式:
json
功能体验
请求参数
| 参数名称 | 类型 | 默认值 | 示例值 | 必须 | 描述 |
|---|---|---|---|---|---|
| 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
}
}
1、系统级返回（所有接入点都会返回的参数）
| 参数名称 | 类型 | 示例值 | 描述 |
|---|---|---|---|
| showapi_res_body | String | {"city":"昆明","prov":"云南"} | 消息体的JSON封装，所有应用级的返回参数将嵌入此对象 。 |
| showapi_res_code | int | 0 | 查看错误码 |
| showapi_res_error | String | 用户输入有误! | 错误信息的展示 |
| showapi_res_id | String | ce135f6739294c63be0c021b76b6fbff | 本次请求id |
2、错误码 (showapi_res_code)
| 状态码 | 描述 |
|---|---|
| 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权限无效 |
