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

# Client-Modus: Talk (Text-Sprachsynthese) - VOICEVOX für Laravel

> Beschreibt die Schritte, um sich im Client-Modus von VOICEVOX für Laravel mit der offiziellen VOICEVOX-Engine zu verbinden und Text-Sprachsynthese durchzuführen.

## Was ist der Client-Modus?

Im Client-Modus werden HTTP-Requests an die offizielle VOICEVOX-Engine gesendet, um Audio zu erzeugen.

Da FFI nicht erforderlich ist, ist er ein leicht zugänglicher Einstiegsmodus zum Ausprobieren.

<Info>
  Falls noch nicht eingerichtet, prüfen Sie zunächst [Installation und Konfiguration](/de/packages/laravel-voicevox/installation).
</Info>

## Vorbereitung

<Steps>
  <Step title="Offizielle Engine starten">
    ```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="Bei Bedarf die Verbindungs-URL konfigurieren">
    ```dotenv theme={null}
    VOICEVOX_URL=http://127.0.0.1:50021
    ```
  </Step>
</Steps>

In Umgebungen mit GPU können Sie auch das GPU-Image nutzen.

## Grundlegende Verwendung

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

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

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

## Angabe der Style-ID

Sie können sowohl an `talk()` als auch an `generate()` eine Style-ID übergeben.

* `talk(id:)`: Style bei der Erstellung des `audio_query`
* `generate(id:)`: Style bei der Sprachsynthese

Üblicherweise wird derselbe Wert angegeben.

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

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

Die Liste der verfügbaren Speaker können Sie mit `speakers()` abrufen.

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

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

## Audio-Query mit `tap()` anpassen

In diesem Paket erhalten Sie vor `generate()` das `TalkAudioQuery`, sodass sich `tap()` sehr sauber zum Einfügen von Nebeneffekten eignet.

```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()` führt nur Feinjustierungen der Query durch; der Rückgabewert kann unverändert an das nächste `generate()` weitergegeben werden. Die Idee ist ausführlich unter [tap()-Helper und Tappable-Trait](/de/advanced/tap) beschrieben.
</Tip>

## Automatische Katakana-Umwandlung von Englisch

Im Client-Modus ist `enable_katakana_english` aktiv, sodass Texte mit englischen Wörtern automatisch in Richtung Katakana korrigiert werden können.

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

Wenn Sie es deaktivieren möchten, übergeben Sie `false` als dritten Parameter.

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

## Response speichern

```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');
```

## Nächste Seiten

<Columns cols={2}>
  <Card title="Client Song" href="/de/packages/laravel-voicevox/client-song" icon="music">
    Bauen Sie `Score` und `Note` für die Gesangssynthese zusammen.
  </Card>

  <Card title="VOICEVOX Core für PHP" href="/de/packages/voicevox-core-php/usage" icon="library">
    Wenn Sie FFI voraussetzen, prüfen Sie auch die Nutzung der Core-Library.
  </Card>
</Columns>


## Related topics

- [Native-Modus: Talk (Text-Sprachsynthese) - VOICEVOX für Laravel](/de/packages/laravel-voicevox/native-talk.md)
- [Engine-API-Modus: Talk (Text-Sprachsynthese) - VOICEVOX für Laravel](/de/packages/laravel-voicevox/engine-talk.md)
- [Engine-API-Modus: Song (Gesangs-Sprachsynthese) - VOICEVOX für Laravel](/de/packages/laravel-voicevox/engine-song.md)
- [Client-Modus: Song (Gesangs-Sprachsynthese) - VOICEVOX für Laravel](/de/packages/laravel-voicevox/client-song.md)
- [Client-Modus - Benutzerwörterbuch - VOICEVOX für Laravel](/de/packages/laravel-voicevox/client-user-dict.md)