腾讯云-语音技术(1978)-支持文档

[TOC] 本接口用于对60秒之内的短音频文件进行识别，支持本地语音文件上传和语音URL上传两种请求方式。 当音频文件通过请求中body内容上传时，请求大小不能超过600KB；当音频以url方式传输时，音频时长不可超过60s。 所有请求参数放在POST请求的body中，编码类型采用x-www-form-urlencoded，参数进行urlencode编码后传输。 现暂只支持中文普通话和带有一定方言口音的中文普通话识别，支持识别8k16bit和16k16bit的mp3或者wav格式的单声道音频。 ### 1. 准备一段语音片段 接口给出的示例语音是： > https://showapi.oss-cn-hangzhou.aliyuncs.com/modleapi/lzh/case13.wav 我们把这段语音传入，看看得到什么结果 ### 2. 在易源测试页面进行调用 进入[易源测试界面](https://www.showapi.com/apiGateway/onlineTest?apiCode=1978&pointCode=1 "易源测试界面")，输入上述文本并进行调用，结果如图：  ### 3. 调用代码 [点此进入接口详情界面](https://www.showapi.com/apiGateway/view?apiCode=1978&pointCode=1 "点此进入接口详情界面") 示例代码如下图：  ### 4. 错误码 如果返回结果中存在 Error 字段，则表示调用 API 接口失败。例如： { "Response": { "Error": { "Code": "AuthFailure.SignatureFailure", "Message": "The provided credentials could not be validated. Please check your signature is correct." }, "RequestId": "ed93f3cb-f35e-473f-b9f3-0d451b8b79c6" } } Error 中的 Code 表示错误码，Message 表示该错误的具体信息。 以下仅列出了接口业务逻辑相关的错误码，其他错误码详见 [公共错误码](https://www.showapi.com/book/view/3654/16 "公共错误码")。 <table><thead><tr><th style="text-align: left;">错误码</th><th style="text-align: left;">说明</th></tr></thead><tbody><tr><td style="text-align: left;">FailedOperation.ServiceIsolate</td><td style="text-align: left;">账号因为欠费停止服务，请在腾讯云账户充值。</td></tr><tr><td style="text-align: left;">FailedOperation.UserHasNoFreeAmount</td><td style="text-align: left;">账号本月免费额度已用完。</td></tr><tr><td style="text-align: left;">FailedOperation.UserNotRegistered</td><td style="text-align: left;">服务未开通，请在腾讯云官网语音识别控制台开通服务。</td></tr><tr><td style="text-align: left;">InternalError</td><td style="text-align: left;">内部错误。</td></tr><tr><td style="text-align: left;">InternalError.ErrorConfigure</td><td style="text-align: left;">初始化配置失败。</td></tr><tr><td style="text-align: left;">InternalError.ErrorCreateLog</td><td style="text-align: left;">创建日志失败。</td></tr><tr><td style="text-align: left;">InternalError.ErrorDownFile</td><td style="text-align: left;">下载音频文件失败。</td></tr><tr><td style="text-align: left;">InternalError.ErrorFailNewprequest</td><td style="text-align: left;">新建数组失败。</td></tr><tr><td style="text-align: left;">InternalError.ErrorFailWritetodb</td><td style="text-align: left;">写入数据库失败。</td></tr><tr><td style="text-align: left;">InternalError.ErrorFileCannotopen</td><td style="text-align: left;">文件无法打开。</td></tr><tr><td style="text-align: left;">InternalError.ErrorGetRoute</td><td style="text-align: left;">获取路由失败。</td></tr><tr><td style="text-align: left;">InternalError.ErrorMakeLogpath</td><td style="text-align: left;">创建日志路径失败。</td></tr><tr><td style="text-align: left;">InternalError.ErrorRecognize</td><td style="text-align: left;">识别失败。</td></tr><tr><td style="text-align: left;">InvalidParameter.ErrorContentlength</td><td style="text-align: left;">请求数据长度无效。</td></tr><tr><td style="text-align: left;">InvalidParameter.ErrorParamsMissing</td><td style="text-align: left;">参数不全。</td></tr><tr><td style="text-align: left;">InvalidParameter.ErrorParsequest</td><td style="text-align: left;">解析请求数据失败。</td></tr><tr><td style="text-align: left;">InvalidParameterValue</td><td style="text-align: left;">参数取值错误。</td></tr><tr><td style="text-align: left;">InvalidParameterValue.ErrorInvalidAppid</td><td style="text-align: left;">AppId无效。</td></tr><tr><td style="text-align: left;">InvalidParameterValue.ErrorInvalidClientip</td><td style="text-align: left;">ClientIp无效。</td></tr><tr><td style="text-align: left;">InvalidParameterValue.ErrorInvalidEngservice</td><td style="text-align: left;">EngSerViceType无效。</td></tr><tr><td style="text-align: left;">InvalidParameterValue.ErrorInvalidProjectid</td><td style="text-align: left;">ProjectId无效。</td></tr><tr><td style="text-align: left;">InvalidParameterValue.ErrorInvalidRequestid</td><td style="text-align: left;">RequestId无效。</td></tr><tr><td style="text-align: left;">InvalidParameterValue.ErrorInvalidSourcetype</td><td style="text-align: left;">SourceType无效。</td></tr><tr><td style="text-align: left;">InvalidParameterValue.ErrorInvalidSubservicetype</td><td style="text-align: left;">SubserviceType无效。</td></tr><tr><td style="text-align: left;">InvalidParameterValue.ErrorInvalidUrl</td><td style="text-align: left;">Url无效。</td></tr><tr><td style="text-align: left;">InvalidParameterValue.ErrorInvalidUseraudiokey</td><td style="text-align: left;">UsrAudioKey无效。</td></tr><tr><td style="text-align: left;">InvalidParameterValue.ErrorInvalidVoiceFormat</td><td style="text-align: left;">音频编码格式不支持。</td></tr><tr><td style="text-align: left;">InvalidParameterValue.ErrorInvalidVoicedata</td><td style="text-align: left;">音频数据无效。</td></tr></tbody></table>