Skip to main content

什麼是 Client 模式

Client 模式會向官方 VOICEVOX 引擎發送 HTTP 請求以產生語音。 不需要 FFI,是最容易入門嘗試的模式。
若尚未導入,請先確認 安裝與設定

事前準備

1

啟動官方引擎

2

必要時設定連線 URL

在有 GPU 的環境也可使用 GPU 映像。

基本用法

Style ID 指定

talk()generate() 都可以傳入 style ID。
  • talk(id:): 建立 audio_query 時的 style
  • generate(id:): 進行語音合成時的 style
一般會指定相同的值。
可用的 speaker 清單可透過 speakers() 取得。

使用 tap() 調整 Audio Query

本套件在 generate() 之前會傳回 TalkAudioQuery,因此以 tap() 只植入副作用的寫法能自然對應。
tap() 只進行 query 的微調,回傳值可直接傳給下一個 generate()。思路詳細整理於 tap() helper 與 Tappable trait

英文自動片假名轉換

Client 模式下 enable_katakana_english 為啟用,含英文的文字會自動修正為偏片假名的讀音。
若要停用,可在第 3 個參數傳入 false

儲存回應

下一步閱讀

Client Song

以歌聲合成建立 ScoreNote

VOICEVOX Core for PHP

若要使用 FFI,可一併確認核心 library 端的用法。
最後修改於 2026年8月2日