跳至主要内容

检查任务状态、获取结果

GET 

/v2/recognitions/:session_id

获取指定语音识别任务的状态和结果。

请求

响应

返回语音识别请求的状态status和相关信息。status可能有以下 5 个值:

status说明
queued任务已注册到队列中的状态。
started任务已从队列中取出,正在准备执行环境的状态。
processing任务正在执行的状态。
completed已从语音识别过程获得结果的状态。如果code为空字符串,即语音识别成功,结果将包含在segments中。
error尝试执行任务时或任务执行过程中发生某些错误的状态。错误详细信息保存在 error_message 中。

下表总结了 queued、started、processing、completed 和 error 各状态下包含的信息。在每个状态的首字母列(q, s, p, c, e)中,A 表示始终包含,O 表示如果有该信息则包含在响应中。

keyqspce说明
statusAAAAA任务状态。可能为 queued、started、processing、completed 或 error。
audio_md5AAO接收到的音频文件的 MD5 校验和值。
audio_sizeAAO接收到的音频文件的大小。
content_idOOOOO用户在请求时设置的 contentId 值。
service_idAAAAService ID。
segmentsA按发话单位的语音识别结果。
utteranceidA识别结果信息 ID。
textA所有"发言区间识别结果"连接的整体识别结果文本。
codeA表示结果的 1 个字符代码。
messageA表示错误内容的字符串。
error_messageA表示错误内容的字符串

当 status 为 completed 时,将以 JSON 格式返回语音识别结果。与同步 HTTP 接口不同,识别结果按发话单位放置在segments下。