실시간 이벤트 레퍼런스
Realtime Speech to Text API에서 수신되는 이벤트 레퍼런스
레퍼런스 · Realtime Speech to Text WebSocket API에서 전송하고 수신하는 모든 이벤트를 나열합니다.
API 및 옵션에 관한 자세한 내용은 Realtime Speech to Text API API 레퍼런스를 참조하세요.
committed_transcript는 각 세그먼트에 대한 안정적인 최종 이벤트입니다. 공개 API는 별도의 final_transcript 이벤트를 내보내지 않습니다.
전송 이벤트
Scribe v3 Live에서는 세션의 첫 번째 input_audio_chunk에 키텀 라이브러리를 포함할 수도 있습니다.
수신 이벤트
언어 코드
쿼리 매개변수에서 include_language_detection=true를 설정하면 partial_transcript 및 committed_transcript_with_timestamps 이벤트의 음성 언어를 language_code로 받을 수 있습니다.
partial_transcript에서language_code는 항상 존재하며, 진행 중인 세그먼트에 언어를 판별할 만큼 충분한 음성이 들어올 때까지null입니다(약 4단어, 또는 중국어·일본어·태국어처럼 공백 없이 쓰는 언어의 경우 8자). 또한 동일한 언어가 연속된 partial에서 확인되어야 합니다. 한 단어처럼 매우 짧은 세그먼트는 계속null일 수 있으며, 언어를 판별하기에 너무 짧은 partial은 연속 partial 수를 초기화합니다. 한 번 설정되면 새 언어가 연속된 partial에서 확인된 후에만 변경되므로, 한 번의 예외적인 partial로 값이 바뀌지 않습니다.- 문장 부호만 있는 경우처럼 발화 텍스트가 없는 partial의
language_code는null입니다. committed_transcript_with_timestamps의language_code는 해당 세그먼트의 최종 결과입니다. 마지막 partial과 다르면 committed 값을 사용하세요. 이는committed_transcript후에 전송되므로, 도착할 때까지는 partial 값을 표시하세요.- 연결 시
language_code또는secondary_languages를 전달하면 해당 언어 내에서 모델이 인식한 언어를 사용합니다. 힌트가 없으면 전사 텍스트에서 감지합니다. include_language_detection=true없이 사용하면partial_transcript이벤트에language_code필드가 없습니다.
오류 처리
오류가 발생하면 WebSocket 연결이 닫히기 전에 오류 메시지가 반환됩니다.