탐색으로 건너뛰기

언어 옵션

이 가이드에서는 Realtime Speech to Text API로 여러 언어의 오디오를 전사하는 방법을 알아봅니다.

방법 가이드 · 클라이언트 측 또는 서버 측 스트리밍 가이드를 완료했다고 가정합니다.

개요

기본적으로 실시간 API는 오디오 언어를 자동으로 감지합니다. 다음 세 가지 방법으로 이 동작을 변경할 수 있습니다.

  • language_code를 오디오의 언어로 설정합니다.
  • secondary_languages를 추가하여 언어 감지 범위를 예상 언어 집합으로 제한합니다.
  • Scribe v3 Live에서 multilang_mode=true를 설정하면 세션 중 언어를 전환하는 화자를 따라갈 수 있습니다.

Scribe는 번역하지 않습니다. 음성은 말한 언어로 전사됩니다.

보조 언어

쿼리 문자열에서 language_code에 기본 언어를 전달하고, 추가 언어마다 secondary_languages를 반복합니다. 둘 다 ISO-639-1 또는 ISO-639-3 코드를 사용할 수 있습니다.

wss://api.elevenlabs.io/v1/speech-to-text/realtime?model_id=scribe_v3_live&language_code=en&secondary_languages=es&secondary_languages=fr

secondary_languages는 감지 대상을 나열한 언어로 제한하여 언어 식별의 신뢰도를 높입니다. 세션 중 언어를 전환하는 화자를 따라가려면 다국어 모드를 사용하세요.

다국어 모드

다국어 모드는 Scribe v3 Live(scribe_v3_live)에서만 사용할 수 있습니다. 다른 모델에서는 multilang_mode=true를 invalid_request 오류와 함께 거부하고 연결을 닫습니다.

multilang_mode=true를 사용하면 Scribe v3 Live는 각 언어를 해당 언어의 문자 체계로 전사하고, 문장 중간 전환을 포함한 언어 전환을 따라갑니다.

wss://api.elevenlabs.io/v1/speech-to-text/realtime?model_id=scribe_v3_live&audio_format=pcm_16000&multilang_mode=true

다국어 모드에는 다음과 같은 절충점이 있습니다.

  • 다른 언어처럼 들리는 배경 음성이 전사될 수 있습니다.
  • 짧은 구문은 잘못 전사될 가능성이 더 높습니다.

공식 SDK는 아직 multilang_mode를 지원하지 않습니다. 사용하려면 WebSocket API에 직접 연결하세요.

다음 단계