跳转到主要内容

什么是用户词典

使用用户词典,你可以让 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_NOUNPROPER_NOUNVERBADJECTIVESUFFIX
  • priority(可选):优先级(默认 5

重音型

  • 0:平板重音
  • 1:第一拍
  • 2:第二拍
  • 3:第三拍

更新词

删除词

获取所有词

导入词典

导出词典

通过引擎 API 访问

如果已启动 Laravel VOICEVOX 的引擎 API,也可以通过 HTTP 操作用户词典。此时不会 fallback 到官方引擎,而是使用原生词典。

获取所有词

添加词

更新词

删除词

导入词典

指定 override=true 时,会先清空所有现有词典再进行导入。

注册词典后的语音合成

注册到用户词典中的词,在语音合成时会自动被参考。

注意事项

pronunciation 请仅使用片假名指定。不能使用平假名或汉字。
  • Laravel 版的用户词典与官方 VOICEVOX 引擎的用户词典是分开管理的。
  • 词的添加、更新、删除会立即保存到 JSON 文件中。
  • 若不确定重音型,可先尝试 0(平板)。

故障排查

词未生效

  1. 请确认存储目录具有写入权限
  2. 请确认 storage/voicevox/user_dict.json 已被正确创建
  3. 请确认片假名表记是否正确

不清楚词典文件的位置

想重置词典

最后修改于 2026年7月18日