> ## Documentation Index > Fetch the complete documentation index at: https://kawax.biz/llms.txt > Use this file to discover all available pages before exploring further. # VOICEVOX für Laravel > Übersicht über das Paket zur Nutzung der Client-, Native- und Engine-API von VOICEVOX aus Laravel sowie die Einstiegspunkte der einzelnen Modi. ## Übersicht [revolution/laravel-voicevox](https://github.com/invokable/laravel-voicevox) ist ein Paket zur Nutzung von VOICEVOX aus Laravel. Sowohl der Client-Modus, der über HTTP eine Verbindung zur offiziellen Engine herstellt, als auch der Native-Modus, der [VOICEVOX Core für PHP](/de/packages/voicevox-core-php) verwendet und direkt über PHP-FFI synthetisiert, lassen sich im gleichen Laravel-Stil verwenden. Wenn Sie zunächst die Grundlagen von FFI ordnen möchten, siehe [PHP FFI](/de/advanced/ffi); zur Einrichtung der Core-Library selbst siehe [VOICEVOX Core für PHP](/de/packages/voicevox-core-php) und [Verwendung](/de/packages/voicevox-core-php/usage). ## Feature-Tabelle | Feature | Supported | Description | | ------------------------------------------- | --------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | VOICEVOX Client | ✅ | Zugriff auf die offizielle VOICEVOX-Engine-API über HTTP. FFI ist nicht erforderlich. | | VOICEVOX Core | ✅ | Nutzt die dynamische Bibliothek von VOICEVOX CORE über [VOICEVOX Core für PHP](/de/packages/voicevox-core-php). | | Laravel style | ✅ | Facade, Helper, `config/voicevox.php`, `.env` – im typischen Laravel-Stil nutzbar. | | Laravel-AI-SDK-Integration | ✅ | Auch über den Audio-Workflow des Laravel AI SDK nutzbar. | | VOICEVOX Engine | ⚠️ | Integriert eine VOICEVOX-kompatible API in die Laravel-Anwendung. Nicht unterstützte Teile fallen auf die offizielle Engine zurück. | | VOICEVOX Engine / OpenAI-kompatible TTS-API | ✅ | Bei `/v1/audio/speech` unterstützt `voice` neben Style-IDs auch Aliase wie „ずんだもん" – analog zum AI SDK. | | VOICEVOX Editor | ⚠️ | Eine song-spezifische App für macOS wurde entwickelt, aber es ist keine Veröffentlichung/Distribution im App Store geplant. Sobald der Code irgendwann auf GitHub veröffentlicht wird, können Sie ihn mit Xcode bauen und verwenden. | ## Anforderungen * PHP 8.3+ * Laravel 12+ * `ext-zip` * Für Native-Modus / Engine-API: `ext-ffi` * Lokale CLI-Umgebung In üblichen Webserver-Umgebungen einschließlich Laravel Cloud ist FFI häufig deaktiviert. Betrachten Sie Native-Modus und Engine-API daher als **auf lokale CLI-Umgebungen ausgelegt**. ## Modusübersicht | Modus | Ausführung | FFI | Hauptzweck | Guide | | ----------- | --------------------------------------------------------- | ------------------ | ----------------------------------- | ---------------------------------------------------------- | | Client Talk | HTTP-Request an die offizielle Engine | Nicht erforderlich | Text-Sprachsynthese | [client-talk](/de/packages/laravel-voicevox/client-talk) | | Client Song | HTTP-Request an die offizielle Engine | Nicht erforderlich | Gesangssynthese | [client-song](/de/packages/laravel-voicevox/client-song) | | Native Talk | Direkter Aufruf von VOICEVOX CORE über FFI | Erforderlich | Lokale Text-Sprachsynthese | [native-talk](/de/packages/laravel-voicevox/native-talk) | | Native Song | Direkter Aufruf von VOICEVOX CORE über FFI | Erforderlich | Lokale Gesangssynthese | [native-song](/de/packages/laravel-voicevox/native-song) | | Engine-API | Bietet die kompatible API innerhalb der Laravel-Anwendung | Erforderlich | Integrierte VOICEVOX-kompatible API | [installation](/de/packages/laravel-voicevox/installation) | ## Warum `tap()` passt Dieses Paket gibt direkt nach `talk()` / `song()` das Audio-Query-Objekt zurück, sodass Sie vor `generate()` eine Anpassungsphase einfügen können. Deshalb ist mit `tap()` das Schreibmuster natürlich, **den Rückgabewert nicht zu ändern, sondern nur die Query anzupassen**. ```php theme={null} 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); ``` * Bei Talk können Sie `speedScale`, `pitchScale` usw. anpassen. * Bei Song können Sie mit `sync()` F0 und Lautstärke neu berechnen. * Sie können sauber an das von `generate()` zurückgegebene `VoicevoxResponse` weiterketten. Die Idee hinter `tap()` selbst ist unter [tap()-Helper und Tappable-Trait](/de/advanced/tap) zusammengefasst. Dieses Paket ist ein besonders anschaulicher praktischer Anwendungsfall. ## Dokumentation Reine Client-Einrichtung, FFI-basierte Einrichtung, Veröffentlichung der Konfigurationsdatei, Vorbereitung der Engine-Ressourcen. Text-Sprachsynthese mit der offiziellen VOICEVOX-Engine starten. `Score` und `Note` zusammenbauen und Gesangssynthese durchführen. Lokale Synthese über PHP-FFI und VOICEVOX CORE. Nutzung des Gesangsmodells direkt über FFI. Einrichtung der Core-Library und Nutzung auf reiner PHP-Seite. ## Referenzlinks * GitHub: [invokable/laravel-voicevox](https://github.com/invokable/laravel-voicevox) * VOICEVOX Core für PHP: [/de/packages/voicevox-core-php](/de/packages/voicevox-core-php) * Verwendung von VOICEVOX Core für PHP: [/de/packages/voicevox-core-php/usage](/de/packages/voicevox-core-php/usage) * PHP FFI: [/de/advanced/ffi](/de/advanced/ffi) * `tap()`-Helper: [/de/advanced/tap](/de/advanced/tap) * Offizielle VOICEVOX-Engine: [VOICEVOX/voicevox\_engine](https://github.com/VOICEVOX/voicevox_engine) ## Related topics - [VoicevoxResponse - VOICEVOX für Laravel](/de/packages/laravel-voicevox/response.md) - [Konfigurationsreferenz - VOICEVOX für Laravel](/de/packages/laravel-voicevox/configuration.md) - [Erste Schritte - VOICEVOX für Laravel](/de/packages/laravel-voicevox/getting-started.md) - [VOICEVOX Core für PHP](/de/packages/voicevox-core-php/index.md) - [Entwicklungsleitfaden für Engine-API-Integrationsanwendungen - VOICEVOX für Laravel](/de/packages/laravel-voicevox/app-guide.md)