/voice/asr/task_online_start

1.接口描述

该 API 用于对语音文件同步识别会话启动。

请求方式

POST

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

2.请求参数

2.1 请求头域

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

2.2 请求体

字段 类型 必需 描述
auf int 否 支持的音频格式，1表示：audio/L16;rate=8000 pcm，5表示：audio/L16;rate=16000 pcm，默认为：1
type string 否 语音识别类型，默认为普通话：1
max_silence int 否 词间隔最大静音时长，控制说话结束的尾点判断，默认为：500
pinyin boolean 否 是否开启拼音功能，默认为：False
role boolean 否 是否开启会话分离功能，默认为：False
punc boolean 否 是否启用标点符号模块，默认为：False
itn boolean 否 是否开启阿拉伯数字功能，默认为：False
vad boolean 否 是否返回VAD结果，开启后在识别到一句话尾点时会返回字级别的时间戳信息，默认为：False
opus boolean 否 是否传输opus音频流，默认为：False
reserved1 string 否 R：坐席；C：用户，默认为：N

3.返回参数

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

3.1 result字段参数

字段 类型 说明
task_id string 本次异步转写任务标识ID
返回结果示例
{
  "status": "OK"
  "request_id": "TIDde0edf26567148ff92e8e5db35ddeaad",
  "result": {
     "task_id":"ba629390-7954-11ef-8622-0242ac11000c",
  },
}

4.错误码

4.1 服务错误码

HTTP状态码 status 字段 说明
400 INVALID_ARGUMENT 请求参数错误
400 START_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 ""