语音识别请求
POST/recognize
发送音频数据和识别用参数,同步接收识别结果。
警告
- 除音频数据外,可以通过查询参数或 multipart 发送。由于在查询参数中设置 d 参数可能会超出请求行的上限,因此建议通过 multipart 发送。
- 如果在查询参数和 multipart 中都指定了相同的参数,则优先使用查询参数中设置的值。
请求
响应
- 200
JSON 格式的识别结果
识别成功时,code == "" 且 message == "" 且 text != ""。
识别失败时,code != "" 且 message != "" 且 text == ""。
code 和 message 列表
当响应中包含的code和message设置了值时,表示请求失败。各代码的详细说明和处理方法请参阅手册的响应代码和消息。
| code | message |
|---|---|
| + | received unsupported audio format |
| - | received illegal service authorization |
| ! | failed to connect to recognizer server |
| > | failed to send audio data to recognizer server |
| < | failed to receive recognition result from recognizer server |
| # | received invalid recognition result from recognizer server |
| $ | timeout occurred while receiving audio data from client |
| % | received too large audio data from client |
| o | recognition result is rejected because confidence is below the threshold |
| b | recognition result is rejected because recognizer server is busy |
| x | recognition result is rejected because grammar files are not loaded |
| c | recognition result is rejected because the recognition process is cancelled |
| ? | recognition result is rejected because fatal error occurred in recognizer server |