Zum Hauptinhalt springen

​
Was zu installieren ist

VOICEVOX für Laravel benötigt je nach genutztem Modus zusätzliche Pakete und eine lokale Einrichtung.
Wenn Sie sich nur per HTTP mit der offiziellen VOICEVOX-Engine verbinden, reicht revolution/laravel-voicevox aus.
composer require revolution/laravel-voicevox

​
Anforderungen

PunktInhalt
PHP8.3+
Laravel12+
Erforderliche Extensionsext-zip
FFI ext-ffiFür Native-Modus / Engine-API erforderlich
In üblichen Webservern einschließlich Laravel Cloud ist FFI deaktiviert. Probieren Sie Native-Modus und Engine-API in einer lokalen CLI-Umgebung aus.

​
Einrichtungsschritte

1

Paket installieren

Führen Sie die Installation je nach genutztem Modus über Composer durch. Für Native-Modus und Engine-API wird auch VOICEVOX Core für PHP benötigt.
2

Konfigurationsdatei veröffentlichen

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

.env konfigurieren

Für den reinen Client-Modus setzen Sie VOICEVOX_URL; bei Nutzung von FFI setzen Sie VOICEVOX_CORE_PATH.
4

Bei Bedarf Engine-Ressourcen installieren

Wenn Sie /speaker_info oder /singer_info nutzen, sind zusätzliche Ressourcen erforderlich.

​
config/voicevox.php

Alle Konfigurationsoptionen finden Sie in der Konfigurationsreferenz. 
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'),
    ],
];

​
Mindestanforderungen an .env

​
Nur Client-Modus

Wenn Sie die offizielle Engine mit dem Standardwert http://127.0.0.1:50021 starten, sind keine zusätzlichen Einstellungen erforderlich. 
VOICEVOX_URL=http://127.0.0.1:50021

​
Native-Modus / Engine-API

VOICEVOX_CORE_PATH=/path/to/voicevox_core/
Der Inhalt von VOICEVOX_CORE_PATH wird gemäß den Schritten in VOICEVOX Core für PHP vorbereitet. Prüfen Sie auch dort die Platzierung von Library, OpenJTalk-Wörterbuch und Modelldateien.

​
FFI aktivieren

In CLI-Umgebungen ist es üblicherweise direkt nutzbar. Wenn Sie die Laravel-Version der Engine-API lokal starten, aktivieren Sie FFI in php.ini. 
ffi.enable=true
Die Funktionsweise und Einschränkungen von FFI sind unter PHP FFI zusammengefasst.

​
Engine-Ressourcen installieren

Wenn Sie Ressourcen-Endpunkte wie /speaker_info oder /singer_info verwenden, installieren Sie separat Ressourcen-Dateien. 
php artisan voicevox:install
In der Orchestra-Testbench-Umgebung lautet der Befehl: 
vendor/bin/testbench voicevox:install

​
Einstiegspunkte je Modus

Client Talk

Starten Sie die offizielle VOICEVOX-Engine über Docker und führen Sie die Text-Sprachsynthese durch.

Client Song

Führen Sie mit Score und Note die Gesangssynthese durch.

Native Talk

Rufen Sie VOICEVOX CORE direkt über FFI auf.

Native Song

Sehen Sie sich Einsatzmöglichkeiten des Gesangsmodells und von sync() an.
Zuletzt geändert am 13. Juli 2026

Verwandte Themen

Detailerklärung zu Score und Note - VOICEVOX für LaravelErste Schritte - VOICEVOX für LaravelEngine-API-Modus: Talk (Text-Sprachsynthese) - VOICEVOX für LaravelNative-Modus: Talk (Text-Sprachsynthese) - VOICEVOX für LaravelNative-Modus: Song (Gesangs-Sprachsynthese) - VOICEVOX für Laravel