安裝與設定 - VOICEVOX for Laravel

要安裝什麼

VOICEVOX for Laravel 需要的追加套件與本機設定會依想使用的模式而異。

僅 Client
也使用 Native / Engine 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`	Native 模式 / Engine API 需要

包含 Laravel Cloud 在內的一般 Web 伺服器上 FFI 為停用。Native 模式與 Engine API 請於 本機 CLI 嘗試。

設定步驟

安裝套件

依想使用的模式以 Composer 導入。Native 模式與 Engine API 也需要 VOICEVOX Core for PHP。

發佈設定檔

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

設定 .env

若只用 Client 模式,設定 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`

僅 Client 模式

若以預設的 http://127.0.0.1:50021 啟動官方引擎則不需追加設定。

VOICEVOX_URL=http://127.0.0.1:50021

Native 模式 / Engine API

VOICEVOX_CORE_PATH=/path/to/voicevox_core/

VOICEVOX_CORE_PATH 的內容需依 VOICEVOX Core for PHP 的步驟準備。library 本體、OpenJTalk 字典、模型檔案的放置也請於該處確認。

啟用 FFI

CLI 中通常可直接使用。若要於本機啟動 Laravel 版引擎 API,請於 php.ini 啟用 FFI。

ffi.enable=true

FFI 的機制與限制整理於 PHP FFI。

安裝引擎資源

使用 /speaker_info 或 /singer_info 等資源相關 endpoint 時,需另外導入資源檔案。

php artisan voicevox:install

Orchestra Testbench 環境使用以下指令。

vendor/bin/testbench voicevox:install

各模式入口

Client Talk

以 Docker 啟動官方 VOICEVOX 引擎進行文字語音合成。

Client Song

使用 Score 與 Note 進行歌聲合成。

Native Talk

透過 FFI 直接呼叫 VOICEVOX CORE。

Native Song

確認歌聲模型與 sync() 的使用時機。

GitHub Copilot

SDK

AI SDK

VOICEVOX

入門套件

Feed 與 RSS

中介層

安裝與設定 - VOICEVOX for Laravel

要安裝什麼

需求

設定步驟

`config/voicevox.php`

最低必要的 `.env`

僅 Client 模式

Native 模式 / Engine API

啟用 FFI

安裝引擎資源

各模式入口

Client Talk

Client Song

Native Talk

Native Song

參考連結

​要安裝什麼

​需求

​設定步驟

​config/voicevox.php

​最低必要的 .env

​僅 Client 模式

​Native 模式 / Engine API

​啟用 FFI

​安裝引擎資源

​各模式入口

Client Talk

Client Song

Native Talk

Native Song

​參考連結

要安裝什麼

需求

設定步驟

`config/voicevox.php`

最低必要的 `.env`

僅 Client 模式

Native 模式 / Engine API

啟用 FFI

安裝引擎資源

各模式入口

參考連結