跳至主要内容

语音识别请求

POST 

/recognize

发送音频数据和识别用参数,同步接收识别结果。

警告
  • 除音频数据外,可以通过查询参数或 multipart 发送。由于在查询参数中设置 d 参数可能会超出请求行的上限,因此建议通过 multipart 发送。
  • 如果在查询参数和 multipart 中都指定了相同的参数,则优先使用查询参数中设置的值。

请求

响应

JSON 格式的识别结果

识别成功时,code == ""message == ""text != ""。 识别失败时,code != ""message != ""text == ""

code 和 message 列表

当响应中包含的codemessage设置了值时,表示请求失败。各代码的详细说明和处理方法请参阅手册的响应代码和消息

codemessage
+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
orecognition result is rejected because confidence is below the threshold
brecognition result is rejected because recognizer server is busy
xrecognition result is rejected because grammar files are not loaded
crecognition result is rejected because the recognition process is cancelled
?recognition result is rejected because fatal error occurred in recognizer server