> ## Documentation Index
> Fetch the complete documentation index at: https://kawax.biz/llms.txt
> Use this file to discover all available pages before exploring further.

# Modalità client: Talk (sintesi vocale da testo) - VOICEVOX for Laravel

> Procedura per eseguire la sintesi vocale da testo in modalità client di VOICEVOX for Laravel connettendosi al motore ufficiale VOICEVOX.

## Cos'è la modalità client

La modalità client genera l'audio inviando richieste HTTP al motore ufficiale VOICEVOX.

Non richiede FFI, quindi è la modalità più semplice per iniziare a provare.

<Info>
  Se non hai ancora effettuato l'installazione, consulta prima [Installazione e configurazione](/it/packages/laravel-voicevox/installation).
</Info>

## Prerequisiti

<Steps>
  <Step title="Avvia il motore ufficiale">
    ```shell theme={null}
    docker pull voicevox/voicevox_engine:cpu-latest
    docker run --rm -p '127.0.0.1:50021:50021' voicevox/voicevox_engine:cpu-latest
    ```
  </Step>

  <Step title="Se necessario, imposta l'URL di destinazione">
    ```dotenv theme={null}
    VOICEVOX_URL=http://127.0.0.1:50021
    ```
  </Step>
</Steps>

Se hai a disposizione una GPU, puoi utilizzare anche l'immagine GPU.

## Utilizzo di base

```php theme={null}
use Revolution\Voicevox\Voicevox;

$response = Voicevox::talk('Laravelが好きなのだ', id: 1)
    ->generate(id: 1);

$response->storeAs('client', 'talk.wav');
```

## Specifica dello style ID

Puoi passare uno style ID sia a `talk()` che a `generate()`.

* `talk(id:)`: stile utilizzato per creare l'`audio_query`
* `generate(id:)`: stile utilizzato per la sintesi vocale

Di norma si specifica lo stesso valore.

```php theme={null}
use Revolution\Voicevox\Voicevox;

$response = Voicevox::talk('ずんだもんなのだ', id: 1)
    ->generate(id: 1);
```

Puoi ottenere l'elenco degli speaker disponibili con `speakers()`.

```php theme={null}
use Revolution\Voicevox\Voicevox;

$speakers = Voicevox::speakers();
```

## Regolazione della audio query con `tap()`

In questo pacchetto puoi ricevere la `TalkAudioQuery` prima di `generate()`, quindi calza perfettamente uno stile in cui inserisci solo effetti collaterali con `tap()`.

```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;
        $talk->audioQuery['pitchScale'] = 0.05;
        $talk->audioQuery['intonationScale'] = 1.5;
        $talk->audioQuery['volumeScale'] = 1.0;
    })
    ->generate(id: 1);
```

<Tip>
  `tap()` esegue solo la regolazione fine della query e ti permette di passare il valore di ritorno tal quale al successivo `generate()`. L'idea è approfondita in [helper tap() e trait Tappable](/it/advanced/tap).
</Tip>

## Conversione automatica dell'inglese in katakana

In modalità client `enable_katakana_english` è abilitato, quindi il testo contenente inglese può essere corretto automaticamente in una forma katakana-like.

```php theme={null}
$response = Voicevox::talk('I love Laravel', id: 1)
    ->generate(id: 1);
```

Se vuoi disabilitarlo, passa `false` come terzo argomento.

```php theme={null}
$response = Voicevox::talk('I love Laravel', id: 1, enableKatakanaEnglish: false)
    ->generate(id: 1);
```

## Salvataggio della risposta

```php theme={null}
$response = Voicevox::talk('テスト', id: 1)->generate(id: 1);

$wav = $response->content();
$path = $response->storeAs('client', 'talk.wav');
$path = $response->storeAs('client', 'talk.wav', disk: 's3');
```

## Pagine successive

<Columns cols={2}>
  <Card title="Client: Song" href="/it/packages/laravel-voicevox/client-song" icon="music">
    Componi `Score` e `Note` per la sintesi del canto.
  </Card>

  <Card title="VOICEVOX Core for PHP" href="/it/packages/voicevox-core-php/usage" icon="library">
    Se decidi di utilizzare FFI, verifica anche l'uso della libreria core.
  </Card>
</Columns>


## Related topics

- [Modalità nativa: Talk (sintesi vocale da testo) - VOICEVOX for Laravel](/it/packages/laravel-voicevox/native-talk.md)
- [Modalità API Engine: Talk (sintesi vocale da testo) - VOICEVOX for Laravel](/it/packages/laravel-voicevox/engine-talk.md)
- [Modalità Engine API: Song (sintesi vocale cantata) - VOICEVOX for Laravel](/it/packages/laravel-voicevox/engine-song.md)
- [Modalità client: Song (sintesi vocale cantata) - VOICEVOX for Laravel](/it/packages/laravel-voicevox/client-song.md)
- [Modalità nativa: Song (sintesi vocale canora) - VOICEVOX for Laravel](/it/packages/laravel-voicevox/native-song.md)