跳到导航
操作指南文本转语音

使用发音词典

本指南介绍如何以编程方式管理发音词典。

操作指南 · 假设你已完成 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

应该能听到通过扬声器播放的两个音频版本：一个使用发音词典，另一个未使用。

后续步骤

API 参考文档

完整的发音词典 API 参考文档。

TTS 流式传输

以流式方式逐步生成文本转语音，降低播放延迟。