录音文件转写 - 开放平台WebAPI V4.3.0

语音转写将长段音频（5小时以内）数据转换成文本数据，为信息处理和数据挖掘提供基础。
上传音频文件成功后进入等待队列，待转写成功后用户即可获取结果，返回结果时间受音频时长以及排队任务量的影响。如遇转写耗时比平时延长，大概率表示当前时间段出现转写高峰，请耐心等待即可，单个任务耗时最大不超过5小时。

音频要求：

项目	说明
支持文件格式	wav及更多格式
采样率	8k/16k/32k/48k
音频大小	单文件最大不超过20MB
音频时长	不超过5小时，建议5分钟以上
语言种类	中文普通话、英文、粤语
获取结果次数	不得超过100次

*** 转写结束异步回调状态
当订单转写流程结束时会进行回调改地址（如果录音文件转写接口传了callbackUrl参数值），我们会把任务编号和转写状态拼接在回调地址中，长度限制为512个字符，具体的格式和参数说明如下：
回调地址示例：GET http://ip:prot/server/xxx?tastId=sdfssldjfljasldjflasjdfl&status=1

参数名	类型	必传
taskId	String	是
status	String	是

请求参数

Header 参数

Content-Type

string

可选

示例值:

application/json

x-vai-token

string

业务Token

可选

Body 参数application/json

channel

string

必需

渠道编号，1-20个英文或数字

fileId

string

文件ID

必需

modelName

string

可选

语种类型：默认 cn cn：中文 en：英文 cn_cantonese：粤语

hotWordId

string

热词Id（优先）

必需

diaSwitch

boolean

必需

是否开启角色分离，默认false，表示不开启角色分离

示例

{
    "channel": "string",
    "fileId": "string",
    "modelName": "string",
    "hotWordId": "string",
    "diaSwitch": true
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Body

rid

string

必需

code

string

错误码 0成功

必需

msg

string

错误消息

必需

data

object

返回结果

可选

taskId

integer

转写任务编号

必需

示例

{
    "rid": "string",
    "code": "string",
    "msg": "string",
    "data": {
        "taskId": 0
    }
}