/voice/asr/task_online_get_result
1.接口描述
该 API 用于对语音文件识别同步结果获取。
请求方式
POST
http://cloudapi.deepfinch.com/voice/asr/task_online_get_result
2.请求参数
2.1 请求头域
字段 |
类型 |
必需 |
描述 |
X-DF-API-ID |
string |
是 |
API调用凭证信息,详细信息请参考API调用 |
X-DF-API-SECRET |
string |
是 |
API调用凭证信息,详细信息请参考API调用 |
2.2 请求体
字段 |
类型 |
必需 |
描述 |
task_id |
string |
是 |
在线转写任务标识ID |
sync_id |
string |
是 |
同步获取标识ID,值应为同步add接口最后一个请求sync_id数+1 |
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 |
语音文件传输失败 |
400 |
TASK_INPROGRESS |
转写任务处理中 |
400 |
TASK_NOT_EXISTS |
转写任务不存在 |
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.输入示例