メインコンテンツへスキップ
Muse の Linux VM で revolution/voicevox-core を使い、チャットで受け取った日本語テキストを音声ファイルに変換する手順です。
VOICEVOX Core は日本語の音声合成に対応しています。このページは VOICEVOX が対応する日本語向けの手順として、日本語版のみを提供します。
ext-ffi は Web サーバー環境では無効になっていることが多く、このパッケージは CLI での実行を前提としています。Muse の VM も再作成されることがあるため、必要なファイルはホームディレクトリ配下に置きます。

検証環境

この手順は次の組み合わせで検証しています。

FFI 用 PHP を用意する

Muse の標準 PHP は static-php-cli 製のため、ext-ffi が含まれていないことがあります。標準 PHP を置き換えず、FFI 専用の PHP 8.3 をホームディレクトリに展開します。
次のラッパーを ~/workspace/tools/bin/php83-ffi として保存します。
実行権限を付け、FFI が有効になっていることを確認します。
class_exists("FFI") が true になれば準備完了です。

VOICEVOX Core のファイルを配置する

公式ダウンローダーが Muse のプロキシを通過できない場合があるため、ダウンローダーが取得する部品を個別に取得し、同じディレクトリ構成に配置します。

C API と ONNX Runtime

OpenJTalk 辞書と音声モデル

tar には --no-same-owner を指定します。Muse では所有者の変更が許可されていないためです。 このページの例では 0.vvm に含まれる、ずんだもんのスタイル ID 3(ノーマル)を使います。VVM のファイル番号と話者は 1 対 1 ではないため、使用するスタイル ID は VVM のメタデータで確認してください。

パッケージをインストールする

Composer も FFI 用 PHP で実行します。

日本語テキストを音声合成する

zundamon.php を作成します。Muse との会話から実行する場合に扱いやすいよう、入力テキストを第 1 引数、出力ファイルを第 2 引数で受け取ります。引数を省略した場合はサンプルのテキストと zundamon.wav を使います。
VOICEVOX Core のライブラリを実行時に見つけられるよう、環境変数を設定します。
引数なしで実行する場合は次のコマンドです。
Muse の会話からテキストと出力先を変える場合は、引数で指定します。
render() を使ったフレーム単位の PCM 生成など、その他の API は 使い方 と API リファレンス を参照してください。

検証結果と注意点

共有 CPU の Muse VM では、上記の例から約 7.67 秒の WAV(24 kHz / 16 bit / モノラル)を生成できました。処理時間は約 9 秒でした。
  • Muse の VM は再作成されることがあるため、PHP やライブラリは ~/workspace/ など永続化される場所に置きます。
  • このパッケージは CLI 専用です。Web サーバーからの実行は ext-ffi の設定と PHP バイナリの構成を別途検討してください。
  • 生成した音声には VOICEVOX および各音声ライブラリの利用規約が適用されます。ずんだもんを使う場合は VOICEVOX:ずんだもん のクレジット表記が必要です。
最終更新日 2026年11月22日