> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cartesia.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 言語

> サポートされている言語、言語ヒント、言語検出

`ink-preview` は [44 言語](#supported-languages)を文字起こしし、話者が 1 つの文の中で複数の言語を混ぜて話した場合でも、言語を自動検出します。想定される言語がわかっている場合は、接続時にヒントとして渡します。

```text theme={null}
wss://api.cartesia.ai/stt/turns/websocket?model=ink-preview&encoding=pcm_s16le&sample_rate=16000&language_hint=hi&language_hint=en
```

ヒントの有無にかかわらず、各ターンでは直近の音声で検出された言語が報告されます。次のヒンディー語の文では、英語の単語「order」「tracking」「help」が使われています。

```json theme={null}
{
  "type": "turn.end",
  "transcript": "नमस्ते। हाँ, मुझे अपने order की tracking को लेकर थोड़ी help चाहिए थी।",
  "languages": [
    { "language": "hi", "confidence": 1.0 },
    { "language": "en", "confidence": 0.643 }
  ]
}
```

> [!NOTE]
>
> `ink-2` は英語、フランス語、ヒンディー語、日本語、スペイン語をサポートし、これらを自動検出します。言語ヒントと検出された言語は `ink-preview` でのみ利用できます。

## サポートされている言語

言語ヒントには次のコードを使用します。検出された言語にも同じコードが使われます。

| 言語 | コード | 言語 | コード |
| - | - | - | - |
| アラビア語 | `ar` | マレー語 | `ms` |
| ベンガル語 | `bn` | マラヤーラム語 | `ml` |
| ブルガリア語 | `bg` | 中国語（標準語） | `zh` |
| 広東語 | `yue` | マラーティー語 | `mr` |
| チェコ語 | `cs` | ノルウェー語 | `no` |
| デンマーク語 | `da` | オディア語 | `or` |
| オランダ語 | `nl` | ポーランド語 | `pl` |
| 英語 | `en` | ポルトガル語 | `pt` |
| フィンランド語 | `fi` | パンジャブ語 | `pa` |
| フランス語 | `fr` | ルーマニア語 | `ro` |
| ジョージア語 | `ka` | ロシア語 | `ru` |
| ドイツ語 | `de` | スロバキア語 | `sk` |
| ギリシャ語 | `el` | スペイン語 | `es` |
| グジャラート語 | `gu` | スウェーデン語 | `sv` |
| ヘブライ語 | `he` | タガログ語 | `tl` |
| ヒンディー語 | `hi` | タミル語 | `ta` |
| ハンガリー語 | `hu` | テルグ語 | `te` |
| インドネシア語 | `id` | タイ語 | `th` |
| イタリア語 | `it` | トルコ語 | `tr` |
| 日本語 | `ja` | ウクライナ語 | `uk` |
| カンナダ語 | `kn` | ウルドゥー語 | `ur` |
| 韓国語 | `ko` | ベトナム語 | `vi` |

## 言語ヒント

言語ヒントは、モデルを想定される言語に寄せるためのものです。モデルはそれ以外の言語も文字起こしでき、ヒントがない場合は言語を自動検出します。

ヒントによって文字起こし精度が向上する場合があるため、事前に言語がわかっている場合は常にヒントを追加することをおすすめします。

* 言語ごとに `language_hint` クエリパラメータを 1 つずつ、最大 6 個まで渡します。URL では `language_hints` も使用できます。`config` メッセージでは `language_hints` を使用してください。そこで `language_hint` フィールドを指定しても無視されます。
* `pt-BR` のような地域コードではなく、`pt` のような上の表の基本コードを使用します。
* サポートされていないコードや 6 個を超えるヒントを指定して接続すると、`error` イベントを受け取り、接続が閉じられます。
* `ink-2` はヒントを受け付けません。ヒントを渡すと `error` イベントが返されます。
* Realtime STT (Manual) で `ink-2` と `ink-preview` を使用する場合は、`language` クエリパラメータを省略してください。これを使用するのは `ink-whisper` のみです。それでも指定する場合、値は `ink-whisper` がサポートする言語である必要があります。

### ストリームの途中でヒントを変更する

`ink-preview` では、`config` メッセージを送信すると、再接続せずにヒントを置き換えられます。これはどちらのリアルタイムエンドポイントでも機能します。

```json theme={null}
{ "type": "config", "language_hints": ["es", "en"] }
```

* 新しいリストは古いリストを置き換えます。リストをクリアするには `[]` を送信し、現在のリストを維持するにはフィールドを省略します。
* 1 つのメッセージで `keyterms` と `language_hints` を同時に変更できます。Realtime STT (Auto) では、どのモデルでも [`turn` 設定](https://docs.cartesia.ai/ja-jp/use-the-api/stt/turns#configuring-turn-detection)も変更できます。
* 変更はすぐに反映されるため、まだ返されていない単語にも適用されます。これには、メッセージの直前の発話が含まれる場合があります。
* メッセージは接続時と同じ制限に照らしてチェックされます。成功した場合、応答はありません。問題がある場合は `error` イベントを受け取り、何も変更されず、接続は開いたままになります。

ストリームの途中でキータームを変更するには、[キータームプロンプティング](https://docs.cartesia.ai/ja-jp/use-the-api/stt/keyterms.md#change-keyterms-mid-stream)を参照してください。

## 検出された言語

[Realtime STT (Auto)](https://docs.cartesia.ai/ja-jp/api-reference/stt/turns/websocket.md) では、`turn.eager_end` と `turn.end` に `languages` リスト（直近の音声で検出された言語）が含まれます。

| フィールド | 型 | 説明 |
| - | - | - |
| `language` | string | 上の表の言語コード |
| `confidence` | number | この言語が話されたことに対するモデルの確信度。0（確信なし）から 1（非常に確信あり）まで |

言語リストは確信度順に並んでいるため、最初のエントリがモデルの最も確信度の高い言語です。エージェントが応答する言語を選ぶ場合など、1 つの言語が必要なときに使用してください。

`ink-2` の場合や、ターンの音声が短すぎて言語を検出できない場合など、このフィールドが存在しないことがあるため、まず存在を確認してください。

```python theme={null}
languages = event.get("languages")
main_language = languages[0]["language"] if languages else None  # None means unknown
```

リストには、モデルが確信を持っている言語が含まれます。どの言語にも確信がない場合は、最も可能性の高い言語のみが含まれます。各言語には個別のスコアが付けられるため、スコアの合計は 1 になりません。たとえば、ヒンディー語と英語を切り替えながら話すターンでは、両方のスコアが高くなることがあります。

[Realtime STT (Manual)](https://docs.cartesia.ai/ja-jp/api-reference/stt/websocket.md) にはターンイベントがありません。代わりに、`flush_done` が各 `finalize` 時に言語を列挙し、`done` がセッション終了時に言語を列挙します。どちらも直近の音声を参照するため、前回の `finalize` より前の発話が含まれる場合があります。前回の `finalize` 以降に音声が届いていない場合、イベントには `languages` が含まれません。無音も音声として扱われるため、発話がない場合は、誰も話していない言語がリストに含まれることがあります。

### 知っておくべきこと

* `turn.eager_end` はターンが終わる前に言語を報告し、`turn.end` は再度言語を報告します。この 2 つは異なる場合があります。`turn.eager_end` で応答を開始する場合は、`turn.end` で言語を再確認し、変わっていれば応答を再生成してください。

* ヒントによって、検出がヒントで指定した言語に限定されるわけではありません。`hi` のヒントを指定したターンでも、発信者が英語を話した場合は `en` として返されることがあります。

## 次に進む

> [card] [単語タイムスタンプ](https://docs.cartesia.ai/ja-jp/use-the-api/stt/word-timestamps.md)
>
> すべての単語の開始時刻と終了時刻

> [card] [キータームプロンプティング](https://docs.cartesia.ai/ja-jp/use-the-api/stt/keyterms.md)
>
> 名前やまれな単語の精度を向上させる

> [card] [API リファレンス](https://docs.cartesia.ai/ja-jp/api-reference/stt/turns/websocket.md)
>
> すべてのイベントとフィールド


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.