インストールと設定 - VOICEVOX for Laravel

何をインストールするか

VOICEVOX for Laravel は、使いたいモードによって追加パッケージとローカルセットアップが変わります。

クライアントのみ
ネイティブ / エンジン API も使う

公式 VOICEVOX エンジンに HTTP で接続するだけなら revolution/laravel-voicevox のみで始められます。

composer require revolution/laravel-voicevox

FFI を使うモードでは revolution/voicevox-core も一緒にインストールします。

composer require revolution/laravel-voicevox revolution/voicevox-core

要件

項目	内容
PHP	8.3+
Laravel	12+
必須拡張	`ext-zip`
FFI `ext-ffi`	ネイティブモード / エンジン API で必要

Laravel Cloud を含む一般的な Web サーバーでは FFI が無効です。ネイティブモードとエンジン API は ローカル CLI で試してください。

セットアップ手順

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

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

設定ファイルを公開する

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

.env を設定する

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

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

/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() の使い所を確認します。

GitHub Copilot

SDK

AI SDK

VOICEVOX

スターターキット

フィード・RSS

ミドルウェア

インストールと設定 - VOICEVOX for Laravel

何をインストールするか

要件

セットアップ手順

`config/voicevox.php`

最低限必要な `.env`

クライアントモードのみ

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

FFI の有効化

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

モードごとの入口

クライアント Talk

クライアント Song

ネイティブ Talk

ネイティブ Song

参考リンク

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

​要件

​セットアップ手順

​config/voicevox.php

​最低限必要な .env

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

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

​FFI の有効化

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

​モードごとの入口

クライアント Talk

クライアント Song

ネイティブ Talk

ネイティブ Song

​参考リンク

何をインストールするか

要件

セットアップ手順

`config/voicevox.php`

最低限必要な `.env`

クライアントモードのみ

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

FFI の有効化

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

モードごとの入口

参考リンク