メインコンテンツへスキップ

​
何をインストールするか

VOICEVOX for Laravel は、使いたいモードによって追加パッケージとローカルセットアップが変わります。
公式 VOICEVOX エンジンに HTTP で接続するだけなら revolution/laravel-voicevox のみで始められます。
composer require revolution/laravel-voicevox

​
要件

項目内容
PHP8.3+
Laravel12+
必須拡張ext-zip
FFI ext-ffiネイティブモード / エンジン API で必要
Laravel Cloud を含む一般的な Web サーバーでは FFI が無効です。ネイティブモードとエンジン API は ローカル CLI で試してください。

​
セットアップ手順

1

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

使いたいモードに応じて Composer で導入します。ネイティブモードとエンジン API では VOICEVOX Core for PHP も必要です。
2

設定ファイルを公開する

php artisan vendor:publish --tag="voicevox-config"
3

.env を設定する

クライアントモードだけなら VOICEVOX_URL、FFI を使うなら VOICEVOX_CORE_PATH を設定します。
4

必要ならエンジンリソースをインストールする

/speaker_info や /singer_info を使う場合は追加リソースが必要です。

​
config/voicevox.php

すべての設定項目は 設定リファレンス で確認できます。 
return [
    'client' => [
        'url' => env('VOICEVOX_URL', 'http://127.0.0.1:50021'),
        'core_version' => env('VOICEVOX_CLIENT_CORE_VERSION'),
    ],

    'core' => [
        'path' => env('VOICEVOX_CORE_PATH'),
        'dict' => env('VOICEVOX_CORE_DICT_PATH', 'dict/open_jtalk_dic_utf_8-1.11'),
        'models' => env('VOICEVOX_CORE_MODELS_PATH', 'models/vvms'),
        'vvms' => ['0.vvm', '9.vvm', 's0.vvm'],
    ],

    'engine' => [
        'disabled' => env('VOICEVOX_ENGINE_DISABLED', false),
        'fallback_url' => env('VOICEVOX_ENGINE_FALLBACK_URL', 'http://127.0.0.1:50021'),
    ],
];

​
最低限必要な .env

​
クライアントモードのみ

デフォルトの http://127.0.0.1:50021 で公式エンジンを起動するなら追加設定は不要です。 
VOICEVOX_URL=http://127.0.0.1:50021

​
ネイティブモード / エンジン API

VOICEVOX_CORE_PATH=/path/to/voicevox_core/
VOICEVOX_CORE_PATH の中身は VOICEVOX Core for PHP の手順で準備します。ライブラリ本体、OpenJTalk 辞書、モデルファイルの配置もそちらで確認してください。

​
FFI の有効化

CLI では通常そのまま使えます。 ローカルで Laravel 版エンジン API を起動する場合は php.ini で FFI を有効にします。 
ffi.enable=true
FFI の仕組みと制約は PHP FFI にまとめています。

​
エンジンリソースのインストール

/speaker_info や /singer_info などのリソース系エンドポイントを使う場合は、別途リソースファイルを導入します。 
php artisan voicevox:install
Orchestra Testbench 環境では次のコマンドです。 
vendor/bin/testbench voicevox:install

​
モードごとの入口

クライアント Talk

公式 VOICEVOX エンジンを Docker で起動してテキスト音声合成します。

クライアント Song

Score と Note を使って歌声合成します。

ネイティブ Talk

FFI で VOICEVOX CORE を直接呼び出します。

ネイティブ Song

歌声モデルと sync() の使い所を確認します。

​
参考リンク

最終更新日 2026年5月24日