> ## 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
> Resumen del paquete que gestiona las APIs cliente, nativa y de motor de VOICEVOX desde Laravel, y punto de entrada a cada modo.
## Resumen
[revolution/laravel-voicevox](https://github.com/invokable/laravel-voicevox) es un paquete para manejar VOICEVOX desde Laravel.
Puedes usar con el mismo estilo Laravel el modo cliente, que se conecta al motor oficial por HTTP, y el modo nativo, que combina [VOICEVOX Core for PHP](/es/packages/voicevox-core-php) para sintetizar directamente vía PHP FFI.
Si quieres repasar antes los fundamentos de FFI, consulta [PHP FFI](/es/advanced/ffi); para la configuración de la propia biblioteca core, consulta [VOICEVOX Core for PHP](/es/packages/voicevox-core-php) y su [guía de uso](/es/packages/voicevox-core-php/usage).
## Tabla de funciones
| Feature | Supported | Description |
| --------------------------------------- | --------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| VOICEVOX Client | ✅ | Accede a la API del motor oficial de VOICEVOX por HTTP. No requiere FFI. |
| VOICEVOX Core | ✅ | Utiliza la biblioteca dinámica de VOICEVOX CORE a través de [VOICEVOX Core for PHP](/es/packages/voicevox-core-php). |
| Laravel style | ✅ | Se maneja al estilo Laravel con facade, helpers, `config/voicevox.php` y `.env`. |
| Integración con Laravel AI SDK | ✅ | También se puede usar desde el flujo de Audio del Laravel AI SDK. |
| VOICEVOX Engine | ⚠️ | Embebe una API compatible con VOICEVOX en la app Laravel. Las partes no cubiertas hacen fallback al motor oficial. |
| VOICEVOX Engine / OpenAI-compat TTS API | ✅ | En `/v1/audio/speech`, el parámetro voice admite, igual que en el AI SDK, alias como «ずんだもん» además del ID de estilo. |
| VOICEVOX Editor | ⚠️ | Se desarrolló una app centrada en canciones para macOS, pero no está previsto publicarla en la tienda. Cuando algún día el código se publique en GitHub, se podrá compilar y usar con Xcode. |
## Requisitos
* PHP 8.3+
* Laravel 12+
* `ext-zip`
* `ext-ffi` si vas a usar el modo nativo o la Engine API
* Un entorno CLI local
En muchos entornos de servidor web comunes, incluido Laravel Cloud, FFI está deshabilitado, así que el modo nativo y la Engine API considéralos **pensados para CLI local**.
## Lista de modos
| Modo | Forma de ejecución | FFI | Uso principal | Guía |
| ------------ | -------------------------------------------------- | ------------ | --------------------------------------- | ---------------------------------------------------------- |
| Cliente Talk | Petición HTTP al motor oficial | No requerido | Síntesis de voz desde texto | [client-talk](/es/packages/laravel-voicevox/client-talk) |
| Cliente Song | Petición HTTP al motor oficial | No requerido | Síntesis de voz cantada | [client-song](/es/packages/laravel-voicevox/client-song) |
| Nativo Talk | Llama directamente a VOICEVOX CORE por FFI | Requerido | Síntesis de voz desde texto en local | [native-talk](/es/packages/laravel-voicevox/native-talk) |
| Nativo Song | Llama directamente a VOICEVOX CORE por FFI | Requerido | Síntesis de voz cantada en local | [native-song](/es/packages/laravel-voicevox/native-song) |
| Engine API | Expone una API compatible dentro de la app Laravel | Requerido | Embeber una API compatible con VOICEVOX | [installation](/es/packages/laravel-voicevox/installation) |
## Por qué encaja bien `tap()`
Este paquete devuelve el objeto Audio Query justo después de `talk()` / `song()`, así que puedes intercalar una fase de ajuste antes de `generate()`.
Por eso, usar `tap()` para **ajustar solo la query sin cambiar el valor de retorno** resulta natural.
```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);
```
* En Talk puedes ajustar `speedScale`, `pitchScale`, etc.
* En Song puedes recalcular F0 y volumen con `sync()`.
* Se encadena limpiamente con el `VoicevoxResponse` que devuelve `generate()`.
El planteamiento de `tap()` en sí se recoge en [Helper tap() y trait Tappable](/es/advanced/tap). Este paquete es un ejemplo especialmente claro como caso práctico.
## Documentación
Revisa la instalación solo cliente, la instalación con FFI, la publicación del archivo de configuración y la preparación de los recursos del motor.
Empieza con la síntesis de voz desde texto usando el motor oficial de VOICEVOX.
Construye `Score` y `Note` para sintetizar voz cantada.
Sintetiza en local con PHP FFI y VOICEVOX CORE.
Usa el modelo de voz cantada directamente vía FFI.
Revisa la configuración de la biblioteca core y su uso del lado Pure PHP.
## Enlaces de referencia
* GitHub: [invokable/laravel-voicevox](https://github.com/invokable/laravel-voicevox)
* VOICEVOX Core for PHP: [/es/packages/voicevox-core-php](/es/packages/voicevox-core-php)
* Uso de VOICEVOX Core for PHP: [/es/packages/voicevox-core-php/usage](/es/packages/voicevox-core-php/usage)
* PHP FFI: [/es/advanced/ffi](/es/advanced/ffi)
* Helper `tap()`: [/es/advanced/tap](/es/advanced/tap)
* Motor oficial de VOICEVOX: [VOICEVOX/voicevox\_engine](https://github.com/VOICEVOX/voicevox_engine)
## Related topics
- [VOICEVOX for Laravel](/it/packages/laravel-voicevox/index.md)