Vai al contenuto principale

​
Panoramica

revolution/laravel-voicevox è un pacchetto per usare VOICEVOX da Laravel. Puoi gestire con lo stesso stile Laravel sia la modalità client, che si connette via HTTP all’engine ufficiale, sia la modalità nativa che, combinata con VOICEVOX Core for PHP, sintetizza direttamente tramite PHP FFI.
Se prima vuoi mettere a fuoco i prerequisiti su FFI, consulta PHP FFI; per l’installazione della libreria core, VOICEVOX Core for PHP e Utilizzo.

​
Tabella delle funzionalità

FeatureSupportedDescription
VOICEVOX Client✅Accede via HTTP all’API del VOICEVOX Engine ufficiale. Non richiede FFI.
VOICEVOX Core✅Utilizza la libreria dinamica VOICEVOX CORE tramite VOICEVOX Core for PHP.
Laravel style✅Puoi utilizzarlo in stile Laravel con facade, helper, config/voicevox.php e .env.
Integrazione Laravel AI SDK✅Utilizzabile anche dal workflow Audio di Laravel AI SDK.
VOICEVOX Engine⚠️Incorpora un’API compatibile VOICEVOX nell’applicazione Laravel. Le parti non supportate ricadono sull’engine ufficiale tramite fallback.
VOICEVOX Engine / API TTS compatibile OpenAI✅/v1/audio/speech voice, come nell’AI SDK, oltre agli ID di stile supporta alias come “ずんだもん”.
VOICEVOX Editor⚠️È stata sviluppata un’app dedicata al canto per macOS, ma non è prevista la pubblicazione o distribuzione tramite app store. Se un giorno il codice venisse pubblicato su GitHub, sarà possibile compilarlo con Xcode per usarlo.

​
Requisiti

  • PHP 8.3+
  • Laravel 12+
  • ext-zip
  • Per usare la modalità nativa / API Engine: ext-ffi
  • Ambiente CLI locale
Negli ambienti server Web comuni, incluso Laravel Cloud, FFI è spesso disabilitato: considera la modalità nativa e l’API Engine come pensate per un ambiente CLI locale.

​
Elenco delle modalità

ModalitàMetodo di esecuzioneFFIUso principaleGuida
Client TalkRichieste HTTP all’engine ufficialeNon necessarioSintesi vocale da testoclient-talk
Client SongRichieste HTTP all’engine ufficialeNon necessarioSintesi canoraclient-song
Native TalkChiamata diretta a VOICEVOX CORE tramite FFINecessarioSintesi vocale da testo in localenative-talk
Native SongChiamata diretta a VOICEVOX CORE tramite FFINecessarioSintesi canora in localenative-song
API EngineFornisce un’API compatibile all’interno dell’app LaravelNecessarioIncorporare un’API compatibile VOICEVOXinstallation

​
Perché tap() si adatta bene

Subito dopo talk() / song() questo pacchetto restituisce un oggetto Audio Query, permettendoti di inserire una fase di regolazione prima di generate(). Per questo, usare tap() rende naturale scrivere codice che regola solo la query senza modificare il valore restituito. 
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);
  • In Talk puoi regolare speedScale, pitchScale, ecc.
  • In Song puoi ricalcolare F0 e volume con sync().
  • Puoi concatenare in modo pulito al VoicevoxResponse restituito da generate().
Il concetto di tap() in sé è approfondito in Helper tap() e trait Tappable. Questo pacchetto ne è un esempio pratico particolarmente comprensibile.

​
Documentazione

Installazione

Introduzione solo lato client, con FFI, pubblicazione del file di configurazione e preparazione delle risorse dell’engine.

Client Talk

Inizia con la sintesi vocale usando il VOICEVOX Engine ufficiale.

Client Song

Costruisci Score e Note per eseguire la sintesi canora.

Native Talk

Sintesi in locale usando PHP FFI e VOICEVOX CORE.

Native Song

Usa direttamente i modelli di canto tramite FFI.

VOICEVOX Core for PHP

Consulta la configurazione della libreria core e il suo utilizzo lato Pure PHP.
Ultima modifica il 13 luglio 2026

Argomenti correlati

VOICEVOX for Laravel