音声認識リクエスト
POST/recognize
音声データと認識用パラメータを送信し、認識結果を同期的に受け取ります。
注意
- 音声データ以外はクエリパラメータでもマルチパートでも送信することができます。クエリパラメータに d パラメータを設定するとリクエストラインの上限を超える可能性があるため、マルチパートで送信することを推奨します。
- クエリパラメータとマルチパートの両方に同じパラメータが指定されている場合、クエリパラメータに設定した値が優先されます。
リクエスト
レスポンス
- 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 |