/voice/asr/task_online_add_audio

1.接口描述

该 API 用于对在线识别任务的语音文件上传，同时获取中间识别结果，通过多次请求实现整个任务的队列中语音文件的上传识别，音频数据建议16K16bit PCM或者8K16bit PCM。

请求方式

POST

http://cloudapi.deepfinch.com/voice/asr/task_online_add_audio

2.请求参数

2.1 请求头域

字段 类型 必需 描述
X-DF-API-ID string 是 API调用凭证信息，详细信息请参考API调用
X-DF-API-SECRET string 是 API调用凭证信息，详细信息请参考API调用

2.2 请求体

字段 类型 必需 描述
file file 见下方注释 需上传的音频文件，上传本地音频进行识别时选取此参数
url string 见下方注释 音频网络地址，采用抓取网络音频方式时需选取此参数
voice_base64 string 见下方注释 Base64格式音频文件数据
task_id string 是 task任务ID
type string 否 语音识别类型，默认为普通话：1
audio_status int 是 音频文件状态，1-第一块音频，2-中间音频
audio_id int 是 音频文件序列id，逐一递加，起始为：1

请求参数 file、url与voice_base64 三选一。
url 中若含有特殊字符，则需要对这些字符进行转义，所有中文和特殊字符必需以UTF-8编码转义。
目前支持 http/https 协议的网络地址。下载限时 5s，超时后仍未下载完成则属于失败。
参数 file 需把音频文件以 multipart/form-data 的形式放到 POST 消息体中。

3.返回参数

字段 类型 说明
request_id string 本次请求的id
status string 状态,正常为 OK
result object 语音转换结果

3.1 result字段参数

字段 类型 说明
task_id string 本次异步转写任务标识ID
asr_status int 引擎识别结果状态，0-中间识别结果，2-正在获取识别结果，5-一句话最终识别结果，其他-出错状态，客户端应结束本次会话
ep_status int 引擎端点状态，1-中间结果，2-已找到端点
base64 string 识别结果base64编码
ppl_base64 string 分词结果base64编码
time array 字级别时间戳
sync_id int 确认标识ID
pgs int 识别结果输出装填，0-当前包没有返回结果，1-有文本结果需要处理
close int 是否session超时，需要关闭本次会话，1-超时，0-未超时
返回结果示例
{
    "status": "OK",
    "result": {
        "task_id": "b237dbd6-cc1f-4dc0-900e-ea7241411567",
        "asr_status": 5,
        "ep_status": 2,
        "base64": "信用卡查询（base64 编码）",
        "ppl_base64": "信用卡[xin4yong4ka3] 查询[cha2xun2]（base64 编码）",
        "time": [[380, 590], [590, 1010]],
        "sync_id": 2,
        "pgs": 1,
        "close": 0
    },
    "request_id":"TID4afe7501e19e46419d7c6e4df8410a2e"
}

4.错误码

4.1 服务错误码

HTTP状态码 status 字段 说明
400 INVALID_ARGUMENT 请求参数错误
400 UPLOAD_FAILED 语音文件传输失败
401 UNAUTHORIZED 未授权或授权失败
401 KEY_EXPIRED 账号过期
403 NO_PERMISSION 无调用权限
403 OUT_OF_QUOTA 调用次数超出限额
403 RATE_LIMIT_EXCEEDED 调用频率超出限额
404 NOT_FOUND 请求路径错误
500 INTERNAL_ERROR 服务器内部错误

备注: 以上40X系列错误描述请参考reason字段

输出样例
{
    "reason": "anvalid argument",
    "request_id": "TID9506904465fd41eb9514d8c2fef36b28",
    "status": "INVALID_ARGUMENT"
}

5.输入示例

results matching ""

    No results matching ""