> This is a page from the ElevenLabs documentation. For a complete page index, fetch https://elevenlabs.io/docs/llms.txt. For the full documentation in a single file, fetch https://elevenlabs.io/docs/llms-full.txt.

# 언어 옵션

> **Note**
>
> **방법 가이드** ·
> [클라이언트 측](/docs/ko/eleven-api/guides/how-to/speech-to-text/realtime/client-side-streaming) 또는
> [서버 측 스트리밍](/docs/ko/eleven-api/guides/how-to/speech-to-text/realtime/server-side-streaming) 가이드를 완료했다고 가정합니다.

## 개요

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

* `language_code`를 오디오의 언어로 설정합니다.
* `secondary_languages`를 추가하여 언어 감지 범위를 예상 언어 집합으로 제한합니다.
* [Scribe v3 Live](/docs/ko/overview/models#scribe-v3-live)에서 `multilang_mode=true`를 설정하면 세션 중 언어를 전환하는 화자를 따라갈 수 있습니다.

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

## 보조 언어

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

```text
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`는 감지 대상을 나열한 언어로 제한하여 언어 식별의 신뢰도를 높입니다. 세션 중 언어를 전환하는 화자를 따라가려면 [다국어 모드](#multilingual-mode)를 사용하세요.

## 다국어 모드

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

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

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

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

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

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

## 다음 단계

#### [전사 및 커밋 전략](/docs/ko/eleven-api/guides/how-to/speech-to-text/realtime/transcripts-and-commit-strategies)

전사를 수동으로, 무음 상태에서 또는 턴 예측으로 커밋합니다.

#### [숫자 및 언어 옵션](/docs/ko/eleven-api/guides/how-to/speech-to-text/batch/number-and-language-options)

녹음된 오디오의 숫자 형식을 지정하고 보조 언어를 선언합니다.