请求说明
更新时间：2020-03-06
接入准备
- 参考“流程说明”—>“免费账号和服务申请”完成权限申请；
- 检查录音文件是否符合为wav或者pcm，非压缩，8000Hz采样率，16bits位深，波形音频格式
- 检查录音音频文件地址可被外网访问和下载
接口调用方式
- 使用应用申请的API Key、Secret Key获取Access Token,详见"获取Access Token"
- 使用获取的AccessToken调用上传请求接口,详见"上传请求接口"
- 使用获取的AccessToken调用结果查询接口,详见"结果查询接口"
获取Access Token
请求URL数据格式
向授权服务地址（https://aip.baidubce.com/oauth/2.0/token）发送请求（推荐使用POST），并在URL中带上以下参数：
- grant_type： 必须参数，固定为client_credentials;
- client_id： 必须参数，应用的API Key;
- client_secret： 必须参数，应用的Secret Key;
例如：
https://aip.baidubce.com/oauth/2.0/token?grant_type=client_credentials&client_id=Va5yQRHlA4Fq5eR3LT0vuXV4&client_secret=0rDSjzQ20XUj5itV6WRtznPQSzr5pVw2&获取access_token各开发语言示例代码请参考accessToken获取
服务器返回的JSON文本参数如下：
- access_token： 要获取的Access Token；
- expires_in： Access Token的有效期(秒为单位，一般为1个月)；
- 其他参数忽略，暂时不用;
例如：
{
"refresh_token": "25.b55fe1d287227ca97aab219bb249b8ab.315360000.1798284651.282335-8574074",
"expires_in": 2592000,
"scope": "public wise_adapt",
"session_key": "9mzdDZXu3dENdFZQurfg0Vz8slgSgvvOAUebNFzyzcpQ5EnbxbF+hfG9DQkpUVQdh4p6HbQcAiz5RmuBAja1JJGgIdJI",
"access_token": "24.6c5e1ff107f0e8bcef8c46d3424a0e78.2592000.1485516651.282335-8574074",
"session_secret": "dfac94a3489fe9fca7c3221cbf7525ff"
}若请求错误，服务器将返回的JSON文本包含以下参数：
error： 错误码；关于错误码的详细信息请参考下方鉴权认证错误码。 error_description： 错误描述信息，帮助理解和解决发生的错误。
例如认证失败返回：
{
"error": "invalid_client",
"error_description": "unknown client id"
}鉴权认证错误码
| error | error_description | 解释 |
|---|---|---|
| invalid_client | unknown client id | API Key不正确 |
| invalid_client | Client authentication failed | Secret Key不正确 |
上传请求接口
获取识别翻译结果有两种方式：
- 采用轮询方式时，提交识别请求后，使用提交参数中appId,callId查询翻译结果。
- 采用回调方式时，提交识别请求的回调url。识别完成后会把结果发送到回调地址。
上传请求URL地址说明
| 协议 | URL | 方法 | 参数 | 备注 |
|---|---|---|---|---|
| HTTPS | https://aip.baidubce.com/rpc/2.0/session/offline/upload/asr?access_token={accessToken} | POST（application/json) | json字符串 | accessToken获取详见"获取Access Token" |
输入参数列表
| 参数名 | 含义 | 必选 | 值类型 |
|---|---|---|---|
| appId | 用户百度智能云申请appId | 必选 | Long |
| callId | 唯一电话识别参数,建议使用UUID,不超过128位,业务方保证(appId,callId)联合唯一 | 必选 | String |
| companyName | 录音所属公司 | 必选 | String |
| agentFileUrl | 用户销售侧文件存储URL或者单个文件的混音文件 | 必选 | String |
| clientFileUrl | 用户客户侧文件存储URL | 非必选 | String |
| callbackUrl | 用户获取翻译结果回调接口,若填写则通过地址回调，若不填则须客户使用查询结果接口进行查询 | 非必选 | String |
| suffix | 文件名后缀 | wav或pcm 必选 | String |
注意事项
- agentFileUrl,clientFileUrl 链接有效性。 请保证下载链接可以被公网访问，关于https：请保证根证书有效且已加入到各公用根证书库。
- agentFileUrl,clientFileUrl 实际可下载文件流要求。请保证文件流满足单声道，8k采样率，16bits采样点，pcm（非pcma律或者pcmu律）语音流。
对文件不确定可用相应软件进行检验。 参考软件为 Adobe Audition CC，录音文件转换工具可参考[音频文件转码]
- callbackUrl链接有效性。请保证回调链接可以被公网访问。关于https：请保证根证书有效且已加入到各公用根证书库。
请求参数示例
输入双侧录音音频地址
{
"appId":11309111,
"companyName":"百度",
"callId":"20e59200-57da-423e-b613-6a8ce126d0a2",
"agentFileUrl":"http://xx.xxx.com/xxx",
"clientFileUrl":"http://xx.xxx.com/xxx",
"callbackUrl":"http://xx.xxx.com/xxx",
"suffix":"wav"
}
或输入单侧录音音频地址
{
"appId": 11309111,
"companyName":"百度",
"callId":"20e59200-57da-423e-b613-6a8ce126d0a2",
"agentFileUrl":"http://xx.xxx.com/xxx",
"callbackUrl":"http://xx.xxx.com/xxx",
"suffix":"wav"
}返回参数列表
| 参数名 | 含义 | 必选 | 值类型 |
|---|---|---|---|
| status | 错误状态码 | 是 | Long |
| msg | 错误信息 | 是 | String |
| data | 返回数据 | 是 | json |
返回格式示例
正确状态返回
{
"status": 0,
"msg": "OK",
"data": ""
}
错误状态返回
{
"status": 50012,
"msg": "callId长度大于128位,请修改callId",
"data": ""
}状态码列表
| status | msg | 处理措施 |
|---|---|---|
| 50000 | appId或callId无效 | 请确认是否是申请音频文件转写应用的appId,详见"流程说明"或者callId是否有效 |
| 50001 | appId和callId联合不唯一,请修改callId | 请修改callId，保证唯一后重试 |
| 50008 | agentFileUrl参数非法,不是url格式 | 修改agentFileUrl参数后重试 |
| 50009 | clientFileUrl参数非法,不是url格式 | 修改clientFileUrl参数后重试 |
| 50010 | callbackUrl参数非法,不是url格式 | 修改callbackUrl参数后重试 |
| 50011 | suffix参数非法,不是wav或pcm | 修改suffix参数为wav或pcm一种后重试 |
| 50012 | callId长度大于128位,请修改callId | 修改callId后重试 |
| 9999 | 系统错误 | 通过联系我们进行反馈 |