/voice/asr/task_offline_add_audio

1.接口描述

该 API 用于对语音文件识别异步上传接口。

请求方式

POST

http://cloudapi.deepfinch.com/voice/asr/task_offline_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-中间音频，4-最后一块音频，只要一块音频时应设置为4，默认为：4
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字段参数

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

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