什么是用户词典
使用用户词典,你可以让 VOICEVOX 记住专有名词和专业术语的读音。注册的词在语音合成时会以恰当的发音朗读。概览
Laravel VOICEVOX 的用户词典功能是基于 VOICEVOX Core 的 UserDict 的原生实现。词典数据以 JSON 形式持久化到storage/voicevox/user_dict.json。
由于使用了与官方 VOICEVOX 引擎独立的存储,在 Laravel 侧注册的词不会同步到官方引擎侧(反之亦然)。
配置
默认保存在storage/voicevox/user_dict.json。若想使用其他路径,可在 config/voicevox.php 中修改。
基本使用
添加词
通过dict() helper 的 add() 注册词。
参数
surface(必需):表记pronunciation(必需):读音(仅片假名)accentType(必需):重音型(0= 平板,1以上 = 重音位置)wordType(可选):词类(COMMON_NOUN、PROPER_NOUN、VERB、ADJECTIVE、SUFFIX)priority(可选):优先级(默认5)
重音型
0:平板重音1:第一拍2:第二拍3:第三拍
更新词
删除词
获取所有词
导入词典
导出词典
通过引擎 API 访问
如果已启动 Laravel VOICEVOX 的引擎 API,也可以通过 HTTP 操作用户词典。此时不会 fallback 到官方引擎,而是使用原生词典。获取所有词
添加词
更新词
删除词
导入词典
注册词典后的语音合成
注册到用户词典中的词,在语音合成时会自动被参考。注意事项
- Laravel 版的用户词典与官方 VOICEVOX 引擎的用户词典是分开管理的。
- 词的添加、更新、删除会立即保存到 JSON 文件中。
- 若不确定重音型,可先尝试
0(平板)。
故障排查
词未生效
- 请确认存储目录具有写入权限
- 请确认
storage/voicevox/user_dict.json已被正确创建 - 请确认片假名表记是否正确