Skip to main content

Laravel AI SDK 整合

VOICEVOX for Laravel 已與 Laravel AI SDK 整合,可以從 Audio Facade 產生語音。 可用的 driver 有以下 2 種。
  • voicevox-client(Client 模式)
  • voicevox(Native 模式)

Client driver(voicevox-client)

向官方 VOICEVOX 引擎發送 HTTP 請求的模式。不需要 FFI。

事前準備

設定

config/ai.php 加入 voicevox-client provider。

用法

Native driver(voicevox)

直接呼叫 VOICEVOX CORE 的模式。需要 FFI。 僅可使用 config/voicevox.phpcore.vvms 中已載入的模型。

設定

用法

voice() 可指定的值

voice() 可指定以下內容。
  • VOICEVOX 的 Style ID(數字字串)
  • 角色名別名(例: ずんだもん四国めたん/ノーマル)

別名一覽

若省略 voice() 會使用 default-female(ID: 10)。
也可透過 Voicevox::speakers() 確認可用的 speaker 清單。

Agent(KanalizerAgent)

Native 模式中沒有 enable_katakana_english,因此可使用將英文事先轉為片假名的 KanalizerAgent
AI 進行的片假名轉換未必總是精確。實際使用時建議先由人員確認產生的文字後再合成。

下一步閱讀

Client: Talk

確認 Client 模式的一般 API 流程。

Native: Talk

確認透過 FFI 直接合成的模式用法。
最後修改於 2026年8月2日