VOICEVOX for Laravel 是一个让你在 Laravel 中使用 VOICEVOX 语音合成功能的包。它可以从文本生成日语语音。
先从客户端模式开始，配置最简单。如果你的环境支持 FFI，之后可以逐步迁移到原生模式或引擎 API 模式。
三种使用模式
| 模式 | 执行方式 | FFI | 适用场景 | 指南 |
|---|
| 客户端模式 | 通过 HTTP 连接官方 VOICEVOX 引擎 | 不需要 | 先试用、Docker 环境、无法使用 FFI 的环境 | Client Talk / Client Song |
| 原生模式 | 通过 PHP FFI 直接调用 VOICEVOX CORE | 需要 | 加速、离线执行、CLI 工具集成 | Native Talk / Native Song |
| 引擎 API 模式 | 由 Laravel 提供 VOICEVOX 兼容 API | 需要 | 公开 API 服务器、多客户端联动 | Engine Talk / Engine Song |
快速开始
以下是客户端模式的步骤。
安装包
composer require revolution/laravel-voicevox
启动官方引擎
docker pull voicevox/voicevox_engine:cpu-latest
docker run --rm -p '127.0.0.1:50021:50021' voicevox/voicevox_engine:cpu-latest
尝试语音合成
use Revolution\Voicevox\Voicevox;
$response = Voicevox::talk('こんにちは、Laravel です。', id: 1)->generate(id: 1);
$response->storeAs('output.wav');
主要功能
语音合成（Talk）
use Revolution\Voicevox\Client\TalkAudioQuery;
use Revolution\Voicevox\Voicevox;
$response = Voicevox::talk('こんにちは', id: 1)
->tap(function (TalkAudioQuery $talk) {
$talk->audioQuery['speedScale'] = 1.2;
$talk->audioQuery['pitchScale'] = 0.05;
$talk->audioQuery['intonationScale'] = 1.5;
$talk->audioQuery['volumeScale'] = 1.0;
})
->generate(id: 1);
歌声合成（Song）
use Revolution\Voicevox\Song\Note;
use Revolution\Voicevox\Song\Score;
use Revolution\Voicevox\Voicevox;
$score = Score::make([
Note::make(length: 15),
Note::make(length: Note::len(ticks: 480, bpm: 120), lyric: 'ド', key: 60),
Note::make(length: Note::len(480, 120), lyric: 'レ', key: 62),
Note::make(length: Note::len(960, 120), lyric: 'ミ', key: 64),
Note::make(length: 2),
]);
$response = Voicevox::song($score)->generate(id: 3001);
用户词典与预设
在客户端模式下，可通过 Voicevox Facade 操作官方引擎侧的用户词典和预设。
use Revolution\Voicevox\Voicevox;
$uuid = Voicevox::addWord(
surface: 'Laravel',
pronunciation: 'ララベル',
accentType: 3,
);
$presetId = Voicevox::addPreset([
'id' => 0,
'name' => 'ゆっくり丁寧',
'speaker_uuid' => '7ffcb7ce-00ec-4bdc-82cd-45a8889e43ff',
'style_id' => 1,
'speedScale' => 0.8,
'pitchScale' => 0.0,
'intonationScale' => 1.2,
'volumeScale' => 1.0,
'prePhonemeLength' => 0.1,
'postPhonemeLength' => 0.1,
]);
Laravel AI SDK 集成
use Laravel\Ai\Audio;
$audio = Audio::of('こんにちは、Laravel です。')
->voice('ずんだもん')
->generate();
$audio->storeAs('output.wav');
下一步
