Vai al contenuto principale

​
Cosa installare

Con VOICEVOX for Laravel, i pacchetti aggiuntivi e la configurazione locale cambiano a seconda della modalità che vuoi usare.
Se devi solo collegarti via HTTP al VOICEVOX Engine ufficiale, puoi iniziare con il solo revolution/laravel-voicevox.
composer require revolution/laravel-voicevox

​
Requisiti

VoceContenuto
PHP8.3+
Laravel12+
Estensione obbligatoriaext-zip
FFI ext-ffiNecessario per modalità nativa / API Engine
Nei server Web comuni, incluso Laravel Cloud, FFI è disabilitato. Prova la modalità nativa e l’API Engine in ambiente CLI locale.

​
Procedura di installazione

1

Installare il pacchetto

Installa tramite Composer in base alla modalità che vuoi usare. Per la modalità nativa e l’API Engine è necessario anche VOICEVOX Core for PHP.
2

Pubblicare il file di configurazione

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

Configurare .env

Per la sola modalità client imposta VOICEVOX_URL; se usi FFI imposta VOICEVOX_CORE_PATH.
4

Installare le risorse dell'engine se necessario

Se usi /speaker_info o /singer_info occorrono risorse aggiuntive.

​
config/voicevox.php

Trovi tutte le voci di configurazione in Riferimento configurazione. 
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 minimo necessario

​
Solo modalità client

Se avvii l’engine ufficiale al valore predefinito http://127.0.0.1:50021, non serve alcuna configurazione aggiuntiva. 
VOICEVOX_URL=http://127.0.0.1:50021

​
Modalità nativa / API Engine

VOICEVOX_CORE_PATH=/path/to/voicevox_core/
Il contenuto di VOICEVOX_CORE_PATH si prepara con la procedura di VOICEVOX Core for PHP. Consulta quella pagina anche per la collocazione della libreria stessa, del dizionario OpenJTalk e dei file dei modelli.

​
Abilitare FFI

In CLI di norma funziona così com’è. Se avvii localmente l’API Engine in versione Laravel, abilita FFI nel php.ini. 
ffi.enable=true
Il funzionamento e i vincoli di FFI sono raccolti in PHP FFI.

​
Installare le risorse dell’engine

Se usi endpoint delle risorse come /speaker_info o /singer_info, installa a parte i file delle risorse. 
php artisan voicevox:install
Negli ambienti Orchestra Testbench il comando è il seguente. 
vendor/bin/testbench voicevox:install

​
Punti di ingresso per ogni modalità

Client Talk

Avvia il VOICEVOX Engine ufficiale con Docker e fai sintesi vocale da testo.

Client Song

Fai sintesi canora usando Score e Note.

Native Talk

Chiama direttamente VOICEVOX CORE tramite FFI.

Native Song

Consulta l’uso dei modelli di canto e di sync().
Ultima modifica il 13 luglio 2026

Argomenti correlati

Riferimento della configurazione - VOICEVOX for LaravelInstallazioneConfigurazioneIntroduzione - VOICEVOX for LaravelVOICEVOX for Laravel