需要安装什么
VOICEVOX for Laravel 根据你要使用的模式，会有不同的附加包与本地准备。
如果只需要通过 HTTP 连接官方 VOICEVOX 引擎，只装 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 是禁用的。请在 本地 CLI 中尝试原生模式与引擎 API。
配置步骤
发布配置文件
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/
启用 FFI
在 CLI 中通常可以直接使用。
本地启动 Laravel 版引擎 API 时，请在 php.ini 中启用 FFI。
FFI 的机制与限制整理在 PHP FFI 中。
安装引擎资源
使用 /speaker_info 或 /singer_info 等资源类端点时，需要另行安装资源文件。
php artisan voicevox:install
vendor/bin/testbench voicevox:install
各模式的入口
客户端 Talk
通过 Docker 启动官方 VOICEVOX 引擎进行文本语音合成。
客户端 Song
使用 Score 与 Note 进行歌声合成。
原生 Talk
通过 FFI 直接调用 VOICEVOX CORE。
原生 Song
了解歌声模型与 sync() 的适用场景。
参考链接
