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

# Modo nativo: Talk (síntesis de voz desde texto) - VOICEVOX for Laravel

> Explica cómo llamar directamente a VOICEVOX CORE con PHP FFI para sintetizar voz desde texto en modo nativo de VOICEVOX for Laravel.

## Qué es el modo nativo

El modo nativo llama directamente a VOICEVOX CORE desde PHP FFI a través de [VOICEVOX Core for PHP](/es/packages/voicevox-core-php).

Puedes sintetizar sin arrancar el motor oficial, pero necesitas configurar FFI y la biblioteca local.

<Warning>
  El modo nativo no está pensado para servidores web. Úsalo en un CLI local. Las restricciones de FFI se explican también en [PHP FFI](/es/advanced/ffi).
</Warning>

## Preparación

1. Haber completado [Instalación y configuración](/es/packages/laravel-voicevox/installation)
2. Haber completado la configuración de [VOICEVOX Core for PHP](/es/packages/voicevox-core-php)
3. Tener configurado `VOICEVOX_CORE_PATH` en `.env`

```dotenv theme={null}
VOICEVOX_CORE_PATH=/path/to/voicevox_core/
```

## Uso básico

En modo nativo se usa el helper `talk()`.

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

$response = talk('ネイティブ版なのだ', id: 1)
    ->generate(id: 1);

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

## Indicar el style ID

En `id` indica un style ID incluido en los `.vvm` ya cargados.

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

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

Solo se pueden usar los modelos incluidos en `core.vvms` de `config/voicevox.php`.

## Ajustar el audio query con `tap()`

En modo nativo, `tap()` se usa igual. Ojo: `TalkAudioQuery` es una clase distinta de la del modo cliente.

```php theme={null}
use Revolution\Voicevox\Talk\TalkAudioQuery;
use function Revolution\Voicevox\talk;

$response = 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);
```

<Info>
  El propio patrón de `tap()` está recogido en [Helper tap() y trait Tappable](/es/advanced/tap). VOICEVOX for Laravel es un ejemplo práctico de ese patrón.
</Info>

## Usar kana con notación tipo AquesTalk

Como el modo nativo no dispone de `enable_katakana_english`, no encaja bien para leer directamente entradas mezcladas con inglés.

En su lugar puedes usar `kana()` para pasar directamente kana en notación tipo AquesTalk.

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

$response = kana("ネイティブ'バンナ/ノダ'", id: 1)
    ->generate(id: 1);

$response->storeAs('native', 'kana.wav');
```

## Diferencias con el modo cliente

| Elemento                                   | Cliente Talk       | Nativo Talk  |
| ------------------------------------------ | ------------------ | ------------ |
| Arranque del motor                         | Necesario          | No necesario |
| FFI                                        | No requerido       | Requerido    |
| Conversión automática de inglés a katakana | Sí                 | No           |
| Entrada de la API                          | `Voicevox::talk()` | `talk()`     |

## Siguientes páginas

<Columns cols={2}>
  <Card title="Nativo Song" href="/es/packages/laravel-voicevox/native-song" icon="music">
    Usa el modelo de voz cantada vía FFI.
  </Card>

  <Card title="VOICEVOX Core for PHP" href="/es/packages/voicevox-core-php" icon="library">
    Revisa la configuración y las restricciones del wrapper PHP puro.
  </Card>
</Columns>


## Related topics

- [Modo cliente: Talk (síntesis de voz desde texto) - VOICEVOX for Laravel](/es/packages/laravel-voicevox/client-talk.md)
- [Modo Engine API: Talk (síntesis de voz desde texto) - VOICEVOX for Laravel](/es/packages/laravel-voicevox/engine-talk.md)
- [Modo Engine API: Song (síntesis de voz cantada) - VOICEVOX for Laravel](/es/packages/laravel-voicevox/engine-song.md)
- [Modo nativo: Song (síntesis de voz cantada) - VOICEVOX for Laravel](/es/packages/laravel-voicevox/native-song.md)
- [Modo cliente: Song (síntesis de voz cantada) - VOICEVOX for Laravel](/es/packages/laravel-voicevox/client-song.md)