# 录音文件转文本
#### 场景描述
录音文件转文本
接口性能指标说明：在8MB文件20TPS的并发下，响应时长小于5s。
#### 接口方法
POST
#### 接口URI
https://域名/apiaccess/CCISQM/rest/ccisqm/v1/openapi/voice2Text，例如域名是service.besclouds.com
#### 请求说明
表1请求头参数 
| 序号 | 名称            | 参数类型   | 是否必选  | 说明                                                            |
|:---|:---|:---|:---|:---|
| 1  | Content-Type  | string | False | 固定填 application/json; charset=UTF-8。                          |
| 2  | x-app-key     | string | False | appKey标识，请联系运营人员获取                                            |
| 3  | Authorization | string | True  | 鉴权字段，内容格式为: Bearer +tokenByAKSK接口的返回值中AccessToken（Bearer后有空格） |
   
表2请求体参数 
| 序号  | 名称            | 参数类型   | 是否必选 | 说明                                   |
|:---|:---|:---|:---|:---|
| 1.1 | language      | string | True | 录音文件语言（zh_CN 代表中文，en_US 代表英文）        |
| 1.2 | voiceFilePath | string | True | 录音文件路径，格式举例：F:\\\\22\\\\22\\\\123.V3 |
| 1.3 | agentId       | number | True | 座席人员工号                               |
| 1.4 | beginTime     | string | True | 通话开始时间，时间格式：yyyy-MM-dd HH:mm:ss      |
| 1.5 | endTime       | string | True | 通话结束时间，时间格式：yyyy-MM-dd HH:mm:ss      |
   
#### 响应说明
- **响应状态码: 200**
表3响应体参数 
| 序号  | 名称         | 参数类型   | 是否必选  | 说明         |
|:---|:---|:---|:---|:---|
| 1.1 | resultCode | string | True  | 响应状态码      |
| 1.2 | resultDesc | string | True  | 响应状态消息     |
| 1.3 | taskId     | string | False | 新建任务的ID    |
| 1.4 | duration   | string | False | 音频时长，单位: 秒 |
   
- **响应状态码: 400**
  请求的内容未找到：请检查请求的路径和各参数的取值。
  
- **响应状态码: 401**
  未授权：1. 请确认是否购买了相关服务。 2. 请联系客服人员检查您账号的当前状态。
  
- **响应状态码: 404**
  未授权：1. 请确认是否购买了相关服务。 2. 请联系客服人员检查您账号的当前状态。
  
- **响应状态码: 500**
  业务失败：请依次确认您请求中各参数的取值。
  
 
#### 错误码
无。
#### 报文样例
- 场景描述：录音文件转文本 请求头:
  ```
  x-app-key:************************************ 
  Authorization:Bearer ************************************
  ```
  请求参数:
  ```
  {
  "language": "zh_CN",
  "voiceFilePath": "Y:\\27\\0\\20210201\\1118\\0951044.V3",
  "agentId": 1118,
  "beginTime": "2021-02-01 09:51:07",
  "endTime": "2021-02-01 09:57:57"
  }
  ```
  响应参数:
  ```
  {
      "resultCode": "1010200",
  "resultDesc": "success",
  "taskId": "608ba63d00000982",
  "duration": "20",
  }
  ```