Saltar al contenido principal

​
Qué instalar

En VOICEVOX for Laravel, los paquetes adicionales y la configuración local cambian según el modo que quieras usar.
Si solo te vas a conectar por HTTP al motor oficial de VOICEVOX, basta con revolution/laravel-voicevox.
composer require revolution/laravel-voicevox

​
Requisitos

ElementoContenido
PHP8.3+
Laravel12+
Extensión obligatoriaext-zip
FFI ext-ffiRequerido 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

Última modificación el 13 de julio de 2026

Temas relacionados

Referencia de configuración - VOICEVOX for LaravelInstalaciónVOICEVOX for LaravelConfiguraciónEmpezar - VOICEVOX for Laravel