# ElevenLabs 发音字典教程：让虚构角色名和缩写在整段配音里读法一致

已制作原创英文专名台词、alias规则与系统朗读参考；未调用ElevenLabs或创建在线字典。系统读法不是字典生效前后的平台A/B结果。

## 环境与许可

ElevenLabs Studio可用账号/额度；输出用途按计划条款。Studio帮助页与API页对phoneme模型范围列举不同，首练只用alias；API需传字典ID与version locator。

## 逐步操作

### 1. 圈出三次虚构专名

script.txt中虚构角色名Qelora出现三次，expected-reading.txt记为keh-LOR-ah；缩写另列，避免同时测试很多未知读法。input.wav是系统朗读审稿参考，不是ElevenLabs默认读法。

### 2. 在Studio新建短项目

把同一份script.txt导入Studio，选定可用voice和模型并先保存不带规则版本。网页项目不是通用聊天API请求，不能把专有功能靠改Base URL接到任何渠道。

### 3. 打开Pronunciations Editor

选中角色名后打开编辑器，确认输入框为完整Qelora。根据官方帮助页新建字典或选择已有字典；不要改正文拼写来掩盖字典没有关联项目。

### 4. 首轮只添加alias规则

用dictionary-rules.json里的string_to_replace和alias概念填写网页字段，把Qelora替换为有助发音的拼写。它是本题规则清单，不是保证可直接导入Studio的原生文件。

### 5. 确认项目关联后生成A/B

先播放编辑器预览，再生成同稿同声音的无规则/有规则两版，保存实际模型和字典版本。phoneme的支持依模型，不因为界面有按钮就假设每个模型都处理。

### 6. 三次出现分别回听

按occurrences.csv核对开头、中间、结尾是否均读成预期，检查规则没有误命中其他词。不要只听预览一次就认定整篇都一致；专名自然度仍需人工判断。

### 7. 导出字典并分清API传参

保存真实字典ID/version和台词，API路径按官方SDK传pronunciation_dictionary_locators。Studio项目设置不会自动随普通TTS请求带入；包内没有真实账号、Key或在线字典ID。

## 下载内容与身份

Original program-authored geometric artwork, not photography, app UI or model output.

macOS Samantha system narration of an original fictional-name script; not ElevenLabs A/B output.

parameters.json 为教学记录而非软件原生导入预设；checks.csv/results.csv 等待实际模型输出填写。

## 文件检查

安装 Python Pillow 后运行 `python3 verify.py`；真实结果可用 `python3 verify.py --result 路径` 回读规格。这个检查不判断模型语义、声音自然度或效果。

## 来源

- https://elevenlabs.io/docs/help-center/product/studio/studio/how-do-i-use-the-pronunciations-editor-in-studio
- https://elevenlabs.io/docs/eleven-api/guides/how-to/text-to-speech/pronunciation-dictionaries
- https://elevenlabs.io/docs/api-reference/pronunciation-dictionaries/create-from-rules

不包含模型权重、账号、真实Key、第三方付费额度或捏造模型输出。
