文档首页/ 云客服/ API参考/ 系统配置类接口参考（API Fabric）/ 智能质检功能集成/ 第三方录音质检接口 (asrtrans)/ 录音文件转文本
更新时间：2025-11-13 GMT+08:00
查看PDF
分享

录音文件转文本

场景描述

录音文件转文本

接口方法

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",
}