> ## 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 for Laravel
> Panoramica del pacchetto per usare le API client, nativa e Engine di VOICEVOX da Laravel e punti di ingresso per ciascuna modalità.
## Panoramica
[revolution/laravel-voicevox](https://github.com/invokable/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](/it/packages/voicevox-core-php), sintetizza direttamente tramite PHP FFI.
Se prima vuoi mettere a fuoco i prerequisiti su FFI, consulta [PHP FFI](/it/advanced/ffi); per l'installazione della libreria core, [VOICEVOX Core for PHP](/it/packages/voicevox-core-php) e [Utilizzo](/it/packages/voicevox-core-php/usage).
## Tabella delle funzionalità
| Feature | Supported | Description |
| -------------------------------------------- | --------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 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](/it/packages/voicevox-core-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 esecuzione | FFI | Uso principale | Guida |
| ----------- | -------------------------------------------------------- | -------------- | --------------------------------------- | ---------------------------------------------------------- |
| Client Talk | Richieste HTTP all'engine ufficiale | Non necessario | Sintesi vocale da testo | [client-talk](/it/packages/laravel-voicevox/client-talk) |
| Client Song | Richieste HTTP all'engine ufficiale | Non necessario | Sintesi canora | [client-song](/it/packages/laravel-voicevox/client-song) |
| Native Talk | Chiamata diretta a VOICEVOX CORE tramite FFI | Necessario | Sintesi vocale da testo in locale | [native-talk](/it/packages/laravel-voicevox/native-talk) |
| Native Song | Chiamata diretta a VOICEVOX CORE tramite FFI | Necessario | Sintesi canora in locale | [native-song](/it/packages/laravel-voicevox/native-song) |
| API Engine | Fornisce un'API compatibile all'interno dell'app Laravel | Necessario | Incorporare un'API compatibile VOICEVOX | [installation](/it/packages/laravel-voicevox/installation) |
## 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**.
```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);
```
* 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](/it/advanced/tap). Questo pacchetto ne è un esempio pratico particolarmente comprensibile.
## Documentazione
Introduzione solo lato client, con FFI, pubblicazione del file di configurazione e preparazione delle risorse dell'engine.
Inizia con la sintesi vocale usando il VOICEVOX Engine ufficiale.
Costruisci `Score` e `Note` per eseguire la sintesi canora.
Sintesi in locale usando PHP FFI e VOICEVOX CORE.
Usa direttamente i modelli di canto tramite FFI.
Consulta la configurazione della libreria core e il suo utilizzo lato Pure PHP.
## Link di riferimento
* GitHub: [invokable/laravel-voicevox](https://github.com/invokable/laravel-voicevox)
* VOICEVOX Core for PHP: [/it/packages/voicevox-core-php](/it/packages/voicevox-core-php)
* Utilizzo di VOICEVOX Core for PHP: [/it/packages/voicevox-core-php/usage](/it/packages/voicevox-core-php/usage)
* PHP FFI: [/it/advanced/ffi](/it/advanced/ffi)
* Helper `tap()`: [/it/advanced/tap](/it/advanced/tap)
* VOICEVOX Engine ufficiale: [VOICEVOX/voicevox\_engine](https://github.com/VOICEVOX/voicevox_engine)
## Related topics
- [VoicevoxResponse - VOICEVOX for Laravel](/it/packages/laravel-voicevox/response.md)
- [Introduzione - VOICEVOX for Laravel](/it/packages/laravel-voicevox/getting-started.md)
- [Installazione e configurazione - VOICEVOX for Laravel](/it/packages/laravel-voicevox/installation.md)
- [Modalità client - Preset - VOICEVOX for Laravel](/it/packages/laravel-voicevox/client-presets.md)
- [Modalità nativa - Preset - VOICEVOX for Laravel](/it/packages/laravel-voicevox/native-presets.md)