> 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/cookbooks/speech-to-text)을 완료했다고 가정합니다.

## 개요

[Scribe v3](/docs/ko/overview/models#scribe-v3)는 배치 텍스트 음성 변환 API에 두 가지 선택적 파라미터를 추가합니다.

* `numbers_format`은 전사문의 숫자를 숫자(`42`) 또는 단어(`forty-two`)로 작성할지 설정합니다.
* `secondary_language_codes`는 `language_code`와 함께 오디오에서 사용될 수 있는 다른 언어를 나열합니다. 화자가 여러 언어를 전환하는 오디오의 정확도를 높여 줍니다.

두 파라미터는 모두 `scribe_v3`에서만 지원됩니다. 다른 모델과 함께 둘 중 하나를 전송하면 `invalid_parameters` 오류가 반환됩니다.

> **Note**
>
> SDK에는 아직 이 파라미터를 위한 타입 인수가 없습니다. Python에서는 `request_options`를 통해
> 전달하세요. TypeScript에서는 `fetch`로 요청을 전송하세요.

## 숫자 형식 지정

`numbers_format`을 `digits` 또는 `words`로 설정하세요. 파라미터를 생략하면 모델이 형식을 선택합니다.

| 값        | 출력 예시       |
| -------- | ----------- |
| `digits` | `42`        |
| `words`  | `forty-two` |
| (생략)     | 모델이 선택      |

```python maxLines=0 {19-24}
import os
from io import BytesIO

import requests
from dotenv import load_dotenv
from elevenlabs.client import ElevenLabs

load_dotenv()

elevenlabs = ElevenLabs(
    api_key=os.getenv("ELEVENLABS_API_KEY"),
)

audio_url = "https://storage.googleapis.com/eleven-public-cdn/audio/marketing/nicole.mp3"
audio_data = BytesIO(requests.get(audio_url).content)

transcription = elevenlabs.speech_to_text.convert(
    file=audio_data,
    model_id="scribe_v3",
    request_options={
        "additional_body_parameters": {
            "numbers_format": "digits",
        },
    },
)

print(transcription.text)
```

```typescript maxLines=0 {10-11}
import "dotenv/config";

const audio = await fetch(
  "https://storage.googleapis.com/eleven-public-cdn/audio/marketing/nicole.mp3"
);
const audioBlob = new Blob([await audio.arrayBuffer()], { type: "audio/mp3" });

const form = new FormData();
form.append("file", audioBlob, "nicole.mp3");
form.append("model_id", "scribe_v3");
form.append("numbers_format", "digits");

const response = await fetch("https://api.elevenlabs.io/v1/speech-to-text", {
  method: "POST",
  headers: { "xi-api-key": process.env.ELEVENLABS_API_KEY! },
  body: form,
});

const transcription = await response.json();
console.log(transcription.text);
```

`numbers_format`은 모델이 숫자를 전사하는 방식을 제어합니다. 날짜, 시간 또는 단위의 표기 방식을 추가로 변경하려면 [전사문 편집](/docs/ko/eleven-api/guides/how-to/speech-to-text/batch/transcript-editing)을 사용하세요.

## 보조 언어 지정

`language_code`는 오디오의 기본 언어로, `secondary_language_codes`는 예상되는 다른 언어로 설정하세요. 둘 다 ISO-639-1 또는 ISO-639-3 코드를 허용합니다.

`secondary_language_codes`는 목록입니다. 언어마다 양식 필드를 한 번씩 반복하세요. 단일 문자열로 전송한 JSON 배열은 허용되지 않습니다.

다음 예시는 스페인어와 프랑스어도 포함된 영어 오디오를 전사합니다.

```python maxLines=0 {4-9}
transcription = elevenlabs.speech_to_text.convert(
    file=audio_data,
    model_id="scribe_v3",
    language_code="en",
    request_options={
        "additional_body_parameters": {
            "secondary_language_codes": ["es", "fr"],
        },
    },
)
```

```typescript maxLines=0 {4-7}
const form = new FormData();
form.append("file", audioBlob, "recording.mp3");
form.append("model_id", "scribe_v3");
form.append("language_code", "en");
for (const code of ["es", "fr"]) {
  form.append("secondary_language_codes", code);
}

const response = await fetch("https://api.elevenlabs.io/v1/speech-to-text", {
  method: "POST",
  headers: { "xi-api-key": process.env.ELEVENLABS_API_KEY! },
  body: form,
});
```

> **Warning**
>
> `secondary_language_codes`의 인식할 수 없는 코드는 오류 없이 건너뜁니다. 요청을 전송하기 전에
> [지원 언어](/docs/ko/overview/capabilities/speech-to-text#supported-languages)에서 코드를 확인하세요.

Scribe v3는 음성이 발화된 언어로 전사합니다. 기본 언어와 보조 언어 간 번역은 수행하지 않습니다.

## 다른 파라미터와 함께 사용

두 파라미터는 `keyterms`, `diarize`, `no_verbatim` 등의 다른 배치 파라미터와 함께 사용할 수 있습니다. 특정 용어에 맞춰 전사 결과를 유도하는 방법은 [키텀 프롬프팅](/docs/ko/eleven-api/guides/how-to/speech-to-text/batch/keyterm-prompting)을 참조하세요.

## 다음 단계

#### [모델](/docs/ko/overview/models#scribe-v3)

Scribe v3 기능 및 Scribe v2에서 업그레이드하는 방법

#### [실시간 언어 옵션](/docs/ko/eleven-api/guides/how-to/speech-to-text/realtime/language-options)

Scribe v3 Live로 두 가지 이상의 언어로 실시간 오디오를 전사합니다.