Skip to main content

什麼是使用者字典

使用使用者字典可讓 VOICEVOX 記住專有名詞或專業術語的讀音。登記的詞彙會在語音合成時以正確發音朗讀。

概觀

Laravel VOICEVOX 的使用者字典功能是使用 VOICEVOX Core 的 UserDict 實作的 Native 實作。字典資料以 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: 第三拍

更新詞彙

刪除詞彙

取得所有詞彙

匯入字典

匯出字典

透過 Engine API 存取

若有啟動 Laravel VOICEVOX 的 Engine API,也可透過 HTTP 操作使用者字典。不會 fallback 至官方引擎,而是使用 Native 字典。

取得所有詞彙

新增詞彙

更新詞彙

刪除詞彙

匯入字典

指定 override=true 會先刪除所有現有字典再匯入。

字典登記後的語音合成

登記於使用者字典的詞彙會在語音合成時自動參照。

注意事項

pronunciation 僅可指定片假名。無法使用平假名或漢字。
  • Laravel 版的使用者字典與官方 VOICEVOX 引擎的使用者字典為分開管理。
  • 詞彙的新增、更新、刪除會立即儲存至 JSON 檔案。
  • 若不清楚重音型別,建議先嘗試 0(平板)。

疑難排解

詞彙未反映

  1. 請確認 storage 目錄的寫入權限
  2. 請確認 storage/voicevox/user_dict.json 是否正確建立
  3. 請確認片假名表記是否正確

找不到字典檔案位置

想重設字典

最後修改於 2026年8月2日