음성 인식 요청
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 |