> ## 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.

# カスタム発音

> 固有名詞やドメイン固有の用語など、正しい発音を得るのが難しい単語に対してカスタム発音を指定します。

発音辞書を使用すると、特定の単語やフレーズの発音方法を指定できます。[デモ](https://play.cartesia.ai/demos/pronunciation)ページで発音ツールを試してみてください。

辞書は単純な検索置換であり、原稿のテキストの代わりに別の文字列を使用するようモデルに指示します。発音には [IPA 発音](/build-with-cartesia/capability-guides/phonemes) または「sounds-like (聞こえ方)」によるガイダンスのいずれかを使用できます。

```json lines theme={null}
[
  {
    "text": "bayou",
    "pronunciation": "<<ˈ|b|ɑ|ˈ|j|u>>"
  },
  {
    "text": "jambalaya",
    "pronunciation": "<<ˈ|dʒ|ə|m|ˈ|b|ə|ˈ|l|aɪ|ˈ|ə>>"
  },
  {
    "text": "tchoupitoulas",
    "pronunciation": "chop-uh-TOO-liss"
  }
]
```

これらの JSON を発音辞書として、[API 経由](/api-reference/pronunciation-dicts/create)または[プレイグラウンド](https://play.cartesia.ai/pronunciation)から保存します。

<img src="https://mintcdn.com/cartesia-2650f86a/e1mnuMNt5eyESNEd/images/image.png?fit=max&auto=format&n=e1mnuMNt5eyESNEd&q=85&s=e5284d8275a53cb69e1fef0f32ccca4c" alt="image.png" width="1264" height="414" data-path="images/image.png" />

辞書を作成したら、その ID を `pronunciation_dict_id` として渡すことで、任意の TTS API で使用できます。

上記の辞書を使用すると、`I ate some jambalaya on tchoupitoulas street` という文字列は、モデルに渡される前に `I ate some <<ˈ|dʒ|ə|m|ˈ|b|ə|ˈ|l|aɪ|ˈ|ə>> on chop-uh-TOO-liss street` に変換されます。

## 大文字小文字の区別

辞書のマッチングは**大文字小文字を区別**しますが、1 つだけ例外があります。小文字のエントリは、文頭で大文字化された形ともマッチします。たとえば、`cat` は `cat` と `Cat` の両方にマッチしますが、`CAT` にはマッチしません。`CAT` のエントリは `CAT` にのみマッチします。

これは複数語のエントリにも当てはまります。`green valley` のエントリは `green valley` と `Green valley` にマッチしますが、`Green Valley` にはマッチしません。

**一般的な単語には小文字のエントリを使用してください。** これにより、文の途中 (`cat`) でも文頭 (`Cat`) でもマッチし、最も一般的な 2 つの位置をカバーできます。

**固有名詞には正確な大文字小文字を使用してください。** `LaTeX` のような用語は `LaTeX` として入力し、一般的な単語 `latex` の別の発音と衝突しないようにします。複数語の固有名詞については、原稿に表示される正確なケースで入力してください。たとえば、原稿で両方の単語が大文字化されている場合は `Green Valley` とします。
