VOICEVOX for Laravel

Overzicht

revolution/laravel-voicevox is een pakket om VOICEVOX te gebruiken vanuit Laravel. Je gebruikt in dezelfde Laravel-stijl zowel de clientmodus, die via HTTP verbinding maakt met de officiële engine, als de native modus, die in combinatie met VOICEVOX Core for PHP rechtstreeks synthetiseert via PHP FFI.

Wil je eerst de basiskennis over FFI op een rij zetten, lees dan PHP FFI; voor de setup van de corebibliotheek zelf, zie VOICEVOX Core for PHP en Gebruik.

Functietabel

Feature	Supported	Description
VOICEVOX Client	✅	Benadert de officiële VOICEVOX-engine-API via HTTP. FFI is niet nodig.
VOICEVOX Core	✅	Gebruikt de dynamische bibliotheek van VOICEVOX CORE via VOICEVOX Core for PHP.
Laravel style	✅	Op z’n Laravels te gebruiken met facades, helpers, `config/voicevox.php` en `.env`.
Laravel AI SDK-integratie	✅	Ook te gebruiken vanuit de Audio-workflow van de Laravel AI SDK.
VOICEVOX Engine	⚠️	Bouwt een VOICEVOX-compatibele API in je Laravel-app in. Niet-ondersteunde onderdelen vallen terug op de officiële engine.
VOICEVOX Engine / OpenAI-compatibele TTS API	✅	`/v1/audio/speech`; voice ondersteunt net als in de AI SDK naast stijl-ID’s ook aliassen zoals “ずんだもん”.
VOICEVOX Editor	⚠️	Er is een songgerichte app voor macOS ontwikkeld, maar er zijn geen plannen om die via een appstore te publiceren of te distribueren. Als de code ooit op GitHub wordt gepubliceerd, kun je hem met Xcode bouwen en gebruiken.

Vereisten

PHP 8.3+
Laravel 12+
ext-zip
ext-ffi als je de native modus / engine-API gebruikt
Een lokale CLI-omgeving

In gangbare webserveromgevingen, waaronder Laravel Cloud, is FFI vaak uitgeschakeld; ga er daarom van uit dat de native modus en de engine-API bedoeld zijn voor een lokale CLI.

Modusoverzicht

Modus	Uitvoering	FFI	Belangrijkste toepassing	Gids
Client Talk	HTTP-requests naar de officiële engine	Niet nodig	Tekst-naar-spraak	client-talk
Client Song	HTTP-requests naar de officiële engine	Niet nodig	Zangsynthese	client-song
Native Talk	VOICEVOX CORE rechtstreeks aanroepen via FFI	Vereist	Lokale tekst-naar-spraak	native-talk
Native Song	VOICEVOX CORE rechtstreeks aanroepen via FFI	Vereist	Lokale zangsynthese	native-song
Engine-API	Compatibele API in de Laravel-app	Vereist	Ingebouwde VOICEVOX-compatibele API	installation

Waarom `tap()` hier zo goed past

Dit pakket geeft direct na talk() / song() het audioquery-object terug en laat je vóór generate() een aanpassingsfase invoegen. Daarom is met tap() de schrijfwijze alleen de query aanpassen zonder de returnwaarde te veranderen heel natuurlijk.

use Revolution\Voicevox\Client\TalkAudioQuery;
use Revolution\Voicevox\Voicevox;

$response = Voicevox::talk('タップで調整できるのだ', id: 1)
    ->tap(function (TalkAudioQuery $talk) {
        $talk->audioQuery['speedScale'] = 1.2;
    })
    ->generate(id: 1);

Bij talk kun je onder andere speedScale en pitchScale aanpassen.
Bij song kun je met sync() F0 en volume opnieuw berekenen.
Je kunt netjes doorchainen naar de VoicevoxResponse die generate() teruggeeft.

De gedachte achter tap() zelf staat beschreven in De tap()-helper en de Tappable-trait. Dit pakket is een bijzonder duidelijk praktijkvoorbeeld.

Documentatie

Installatie

Bekijk installatie met alleen de client, installatie met FFI, het publiceren van het configuratiebestand en het voorbereiden van engine-resources.

Client Talk

Begin met tekst-naar-spraak via de officiële VOICEVOX-engine.

Client Song

Bouw een Score en Notes op en synthetiseer zang.

Native Talk

Synthetiseer lokaal met PHP FFI en VOICEVOX CORE.

Native Song

Gebruik het zangmodel rechtstreeks via FFI.

VOICEVOX Core for PHP

Bekijk de setup van de corebibliotheek en het gebruik aan de pure-PHP-kant.

Referenties

GitHub: invokable/laravel-voicevox
VOICEVOX Core for PHP: /nl/packages/voicevox-core-php
VOICEVOX Core for PHP gebruiken: /nl/packages/voicevox-core-php/usage
PHP FFI: /nl/advanced/ffi
De tap()-helper: /nl/advanced/tap
Officiële VOICEVOX-engine: VOICEVOX/voicevox_engine

GitHub Copilot

SDK

AI SDK

VOICEVOX

Starter kits

Feeds en RSS

Middleware

Overzicht

Functietabel

Vereisten

Modusoverzicht

Waarom `tap()` hier zo goed past

Documentatie

Installatie

Client Talk

Client Song

Native Talk

Native Song

VOICEVOX Core for PHP

Referenties

​Overzicht

​Functietabel

​Vereisten

​Modusoverzicht

​Waarom tap() hier zo goed past

​Documentatie

Installatie

Client Talk

Client Song

Native Talk

Native Song

VOICEVOX Core for PHP

​Referenties

Overzicht

Functietabel

Vereisten

Modusoverzicht

Waarom `tap()` hier zo goed past

Documentatie

Referenties