ナビゲーションにスキップ
ハウツーガイドテキスト読み上げ

発音辞書の使用

このガイドでは、発音辞書をプログラムで管理する方法を紹介します。

使い方ガイド · ElevenAPI クイックスタートを完了していることを前提としています。

概要

発音辞書を使うと、AIエージェントが特定の単語やフレーズを発音する方法をカスタマイズできます。特に、次のような場合に便利です。

  • 名前、地名、技術用語の発音を修正する
  • 会話全体で一貫した発音を保つ
  • 地域ごとの発音の違いをカスタマイズする

ElevenLabsは、IPAとCMUの両方のアルファベットをサポートしています。

発音辞書の音素タグは、eleven_v4、eleven_v4_turbo、eleven_flash_v2、eleven_v3モデルでのみ機能します。

他のモデルでは辞書の音素タグはスキップされ、デフォルトの発音が使用されます。ほかのモデルでは、必要な発音になるスペルやフレーズに置き換えるため、代わりにエイリアスタグを使用してください。

英語以外の言語でIPAおよびCMUの発音を使用する場合は、eleven_v4またはeleven_v4_turboモデルに切り替える必要があります。

クイックスタート

このガイドでは、APIキーとSDKの設定が完了していることを前提としています。まだの場合は、先にクイックスタートを完了してください。

1

発音辞書ファイルを作成

この例では、単語tomato用の発音辞書ファイルを作成します。

このルールでは「IPA」アルファベットを使用し、tomatoとTomatoの発音を別の発音に更新します。PLSファイルでは大文字と小文字が区別されるため、大文字の「T」を含むものと含まないものの両方を指定しています。

ClaudeやChatGPTなどのAIツールを使用すると、特定の単語のIPAまたはCMU表記を作成できます。

dictionary.pls
<?xml version="1.0" encoding="UTF-8"?>
<lexicon version="1.0"
    xmlns="http://www.w3.org/2005/01/pronunciation-lexicon"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:schemaLocation="http://www.w3.org/2005/01/pronunciation-lexicon
        http://www.w3.org/TR/2007/CR-pronunciation-lexicon-20071212/pls.xsd"
    alphabet="ipa" xml:lang="en-US">
<lexeme>
    <grapheme>tomato</grapheme>
    <phoneme>/tə'meɪtoʊ/</phoneme>
</lexeme>
<lexeme>
    <grapheme>Tomato</grapheme>
    <phoneme>/tə'meɪtoʊ/</phoneme>
</lexeme>
</lexicon>
2

SDKを使用してファイルから発音辞書を作成

使用する言語に応じて、example.pyまたはexample.mtsという名前の新しいファイルを作成し、次のコードを追加します。

from elevenlabs import ElevenLabs, PronunciationDictionaryVersionLocator
from elevenlabs.play import play
elevenlabs = ElevenLabs()
with open("dictionary.pls", "rb") as f:
    # this dictionary changes how tomato is pronounced
    pronunciation_dictionary = elevenlabs.pronunciation_dictionaries.create_from_file(
        file=f.read(), name="example"
    )
audio_1 = elevenlabs.text_to_speech.convert(
    text="Without the dictionary: tomato",
    voice_id="aMSt68OGf4xUZAnLpTU8",
    model_id="eleven_v4_turbo",
)
audio_2 = elevenlabs.text_to_speech.convert(
    text="With the dictionary: tomato",
    voice_id="aMSt68OGf4xUZAnLpTU8",
    model_id="eleven_v4_turbo",
    pronunciation_dictionary_locators=[
        PronunciationDictionaryVersionLocator(
            pronunciation_dictionary_id=pronunciation_dictionary.id,
            version_id=pronunciation_dictionary.version_id,
        )
    ],
)
# play the audio
play(audio_1)
play(audio_2)
3

コードを実行

python example.py

スピーカーから、発音辞書を使用したものと使用していないもの、2種類のオーディオが再生されます。

次のステップ

APIリファレンス

発音辞書APIの完全なリファレンス。

TTSストリーミング

テキスト読み上げを段階的にストリーミングし、再生時のレイテンシーを低減します。