安装与配置 - VOICEVOX for Laravel

需要安装什么

VOICEVOX for Laravel 根据你要使用的模式，会有不同的附加包与本地准备。

仅客户端
也使用原生 / 引擎 API

如果只需要通过 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。

配置步骤

安装包

根据要使用的模式，通过 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

通过 Docker 启动官方 VOICEVOX 引擎进行文本语音合成。

客户端 Song

使用 Score 与 Note 进行歌声合成。

原生 Talk

通过 FFI 直接调用 VOICEVOX CORE。

原生 Song

了解歌声模型与 sync() 的适用场景。

GitHub Copilot

SDK

AI SDK

VOICEVOX

启动套件

Feed 与 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

安装引擎资源

各模式的入口

参考链接