检查任务状态、获取结果
GET/v2/recognitions/:session_id
获取指定语音识别任务的状态和结果。
请求
响应
- 200
- 401
- 404
- 500
返回语音识别请求的状态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 表示如果有该信息则包含在响应中。
| key | q | s | p | c | e | 说明 |
|---|---|---|---|---|---|---|
| status | A | A | A | A | A | 任务状态。可能为 queued、started、processing、completed 或 error。 |
| audio_md5 | A | A | O | 接收到的音频文件的 MD5 校验和值。 | ||
| audio_size | A | A | O | 接收到的音频文件的大小。 | ||
| content_id | O | O | O | O | O | 用户在请求时设置的 contentId 值。 |
| service_id | A | A | A | A | Service ID。 | |
| segments | A | 按发话单位的语音识别结果。 | ||||
| utteranceid | A | 识别结果信息 ID。 | ||||
| text | A | 所有"发言区间识别结果"连接的整体识别结果文本。 | ||||
| code | A | 表示结果的 1 个字符代码。 | ||||
| message | A | 表示错误内容的字符串。 | ||||
| error_message | A | 表示错误内容的字符串 |
当 status 为 completed 时,将以 JSON 格式返回语音识别结果。与同步 HTTP 接口不同,识别结果按发话单位放置在segments下。
认证失败时返回。
| 错误消息 | 错误情况 |
|---|---|
| No authorization header | 未设置 Authorization header |
| Invalid authorization header format | Authorization header 格式不正确 |
| Failed to authorize for the API key | 使用指定的 API key 进行认证失败 |
找不到指定的 session_id 的任务时返回。
| 错误消息 | 错误情况 |
|---|---|
| Specified session_id is not found | 找不到指定的 session_id 的任务 |
如果指定了正确的session_id但仍出现此错误,可能是以下情况:
- 超过数据保存期限
- 与请求时不同的用户尝试获取任务状态或结果
内部错误时返回。
| 错误消息 | 错误情况 |
|---|---|
| - | 内部错误。请联系我们。 |