Laravel AI SDK-integratie

VOICEVOX for Laravel is geïntegreerd met de Laravel AI SDK, zodat je spraak kunt genereren via de Audio-facade. Er zijn twee drivers beschikbaar.

voicevox-client (clientmodus)
voicevox (native modus)

Clientdriver (`voicevox-client`)

Deze modus verstuurt HTTP-requests naar de officiële VOICEVOX-engine. FFI is niet nodig.

Voorbereiding

docker pull voicevox/voicevox_engine:cpu-latest
docker run --rm -p '127.0.0.1:50021:50021' voicevox/voicevox_engine:cpu-latest

Configuratie

Voeg de provider voicevox-client toe aan config/ai.php.

'providers' => [
    'voicevox-client' => [
        'driver' => 'voicevox-client',
        'key' => env('VOICEVOX_URL', 'http://127.0.0.1:50021'),
    ],
],

Gebruik

use Laravel\Ai\Audio;

$response = Audio::of('Laravelが好きなのだ')
    ->voice('ずんだもん')
    ->generate('voicevox-client');

Storage::put('talk.wav', $response->content());

Native driver (`voicevox`)

Deze modus roept VOICEVOX CORE rechtstreeks aan. FFI is vereist. Alleen de modellen die zijn geladen via core.vvms in config/voicevox.php zijn beschikbaar.

Configuratie

'providers' => [
    'voicevox' => [
        'driver' => 'voicevox',
    ],
],

Gebruik

use Laravel\Ai\Audio;

$response = Audio::of('ネイティブで話すのだ')
    ->voice('ずんだもん')
    ->generate('voicevox');

Storage::put('talk.wav', $response->content());

Waarden die je aan `voice()` kunt meegeven

Aan voice() kun je het volgende meegeven.

Een VOICEVOX-stijl-ID (numerieke string)
Een alias met de karakternaam (bijvoorbeeld ずんだもん, 四国めたん/ノーマル)

Overzicht van aliassen

Alias	Stijl-ID	Karakter
`ずんだもん`	1	Zundamon (amaama)
`ずんだもん/あまあま`	1	Zundamon (amaama)
`ずんだもん/ノーマル`	3	Zundamon (normaal)
`ずんだもん/セクシー`	5	Zundamon (sexy)
`ずんだもん/ツンツン`	7	Zundamon (tsuntsun)
`ずんだもん/ささやき`	22	Zundamon (fluisteren)
`ずんだもん/ヒソヒソ`	38	Zundamon (gefluister)
`四国めたん/あまあま`	0	Shikoku Metan (amaama)
`四国めたん`	2	Shikoku Metan (normaal)
`四国めたん/ノーマル`	2	Shikoku Metan (normaal)
`四国めたん/セクシー`	4	Shikoku Metan (sexy)
`四国めたん/ツンツン`	6	Shikoku Metan (tsuntsun)
`四国めたん/ヒソヒソ`	37	Shikoku Metan (gefluister)
`春日部つむぎ`	8	Kasukabe Tsumugi (normaal)
`波音リツ`	9	Namine Ritsu (normaal)
`雨晴はう`	10	Amehare Hau (normaal)
`玄野武宏`	11	Kurono Takehiro (normaal)
`白上虎太郎`	12	Shirakami Kotarou (normaal)
`青山龍星`	13	Aoyama Ryusei (normaal)
`冥鳴ひまり`	14	Meimei Himari (normaal)
`九州そら`	16	Kyushu Sora (normaal)
`default-female`	10	Amehare Hau (normaal)
`default-male`	12	Shirakami Kotarou (normaal)

Als je voice() weglaat, wordt default-female (ID: 10) gebruikt.

use Laravel\Ai\Audio;

Audio::of('テスト')->voice('3')->generate('voicevox-client');

Je kunt de lijst met beschikbare speakers ook opvragen met Voicevox::speakers().

use Revolution\Voicevox\Voicevox;

$speakers = Voicevox::speakers();

Agent (KanalizerAgent)

Omdat de native modus geen enable_katakana_english heeft, kun je de KanalizerAgent gebruiken die Engels vooraf omzet naar katakana.

use Revolution\Voicevox\Ai\Agents\KanalizerAgent;
use function Revolution\Voicevox\talk;

$kana = KanalizerAgent::make()->prompt('KanalizerAgentで英語をカタカナに変換するのだ');

$response = talk($kana['kana'] ?? $kana->text, id: 1)->generate(id: 1);

$response->storeAs('native', 'kanalizer.wav');

De katakana-conversie door AI is niet altijd correct. Laat in productie de gegenereerde tekst door een mens controleren voordat je die synthetiseert.

GitHub Copilot

SDK

AI SDK

VOICEVOX

Starter kits

Feeds en RSS

Middleware

Laravel AI SDK-integratie - VOICEVOX for Laravel