Instalación y configuración - VOICEVOX for Laravel

Explica cómo instalar VOICEVOX for Laravel, según se use FFI o no, el archivo de configuración, .env y la preparación de recursos del motor.

​

Qué instalar

En VOICEVOX for Laravel, los paquetes adicionales y la configuración local cambian según el modo que quieras usar.

Solo cliente

Si solo te vas a conectar por HTTP al motor oficial de VOICEVOX, basta con revolution/laravel-voicevox.

composer require revolution/laravel-voicevox

Usar también nativo / Engine API

En los modos que usan FFI también instala revolution/voicevox-core.

composer require revolution/laravel-voicevox revolution/voicevox-core

​

Requisitos

Elemento	Contenido
PHP	8.3+
Laravel	12+
Extensión obligatoria	ext-zip
FFI ext-ffi	Requerido en modo nativo / Engine API

En servidores web comunes, incluido Laravel Cloud, FFI está deshabilitado. Prueba el modo nativo y la Engine API en un CLI local.

​

Pasos de configuración

1. Instala el paquete

   Instálalo con Composer según el modo que quieras usar. En modo nativo y Engine API también necesitas VOICEVOX Core for PHP.

2. Publica el archivo de configuración

   php artisan vendor:publish --tag="voicevox-config"
   
3. Configura .env

   Solo para modo cliente, configura VOICEVOX_URL; si usas FFI, configura VOICEVOX_CORE_PATH.

4. Si es necesario, instala los recursos del motor

   Para usar /speaker_info o /singer_info se requieren recursos adicionales.

​

config/voicevox.php

Puedes ver todas las opciones en la referencia de configuración.

return [
    'client' => [
        'url' => env('VOICEVOX_URL', 'http://127.0.0.1:50021'),
        'core_version' => env('VOICEVOX_CLIENT_CORE_VERSION'),
    ],

    'core' => [
        'path' => env('VOICEVOX_CORE_PATH'),
        'dict' => env('VOICEVOX_CORE_DICT_PATH', 'dict/open_jtalk_dic_utf_8-1.11'),
        'models' => env('VOICEVOX_CORE_MODELS_PATH', 'models/vvms'),
        'vvms' => ['0.vvm', '9.vvm', 's0.vvm'],
    ],

    'engine' => [
        'disabled' => env('VOICEVOX_ENGINE_DISABLED', false),
        'fallback_url' => env('VOICEVOX_ENGINE_FALLBACK_URL', 'http://127.0.0.1:50021'),
    ],
];

​

.env mínimo necesario

​

Solo modo cliente

Si arrancas el motor oficial en el http://127.0.0.1:50021 por defecto, no necesitas más configuración.

VOICEVOX_URL=http://127.0.0.1:50021

​

Modo nativo / Engine API

VOICEVOX_CORE_PATH=/path/to/voicevox_core/

El contenido de VOICEVOX_CORE_PATH se prepara con los pasos de VOICEVOX Core for PHP. La ubicación de la biblioteca, del diccionario OpenJTalk y de los archivos de modelo también se explica allí.

​

Habilitar FFI

En CLI suele funcionar tal cual.

Si vas a arrancar la API del motor versión Laravel en local, habilita FFI en php.ini.

ffi.enable=true

Los detalles y limitaciones de FFI están recogidos en PHP FFI.

​

Instalación de recursos del motor

Para usar endpoints de recursos como /speaker_info o /singer_info debes instalar los archivos de recursos por separado.

php artisan voicevox:install

En entornos con Orchestra Testbench, el comando es:

vendor/bin/testbench voicevox:install

​

Entradas por modo

Cliente Talk

Arranca el motor oficial de VOICEVOX en Docker y sintetiza voz desde texto.

Cliente Song

Sintetiza voz cantada usando Score y Note.

Nativo Talk

Llama directamente a VOICEVOX CORE vía FFI.

Nativo Song

Revisa el modelo de voz cantada y cuándo usar sync().

​

Enlaces de referencia

• Resumen de VOICEVOX for Laravel
• Empezar
• Referencia de configuración
• VOICEVOX Core for PHP
• Uso de VOICEVOX Core for PHP
• PHP FFI