> 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**
>
> **ハウツーガイド** · [スピーチtoテキストの クイックスタート](/docs/ja/eleven-api/guides/cookbooks/speech-to-text)を完了していることを前提としています。

## 概要

[Scribe v3](/docs/ja/overview/models#scribe-v3)では、バッチのスピーチtoテキストAPIに2つのオプションパラメータが追加されています。

* `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/ja/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` はリストです。言語ごとにフォームフィールドを1回ずつ指定してください。単一の文字列として送信された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/ja/overview/capabilities/speech-to-text#supported-languages)でコードを
> 確認してください。

Scribe v3は、音声が話されている言語のまま文字起こしします。主要言語と第二言語の間で翻訳は行いません。

## ほかのパラメータとの組み合わせ

どちらのパラメータも同時に使用でき、`keyterms`、`diarize`、`no_verbatim` など、ほかのバッチパラメータとも併用できます。特定の語を優先的に文字起こしする方法については、[キータームプロンプティング](/docs/ja/eleven-api/guides/how-to/speech-to-text/batch/keyterm-prompting)をご覧ください。

## 次のステップ

#### [モデル](/docs/ja/overview/models#scribe-v3)

Scribe v3の機能と、Scribe v2からアップグレードする方法。

#### [リアルタイムの言語オプション](/docs/ja/eleven-api/guides/how-to/speech-to-text/realtime/language-options)

Scribe v3 Liveを使って、複数の言語を含むライブオーディオを文字起こしします。