Installation and setup - VOICEVOX for Laravel

What to install

VOICEVOX for Laravel varies in the additional packages and local setup required depending on the mode you use.

Client only
Native / engine API

If you only need to connect to the official VOICEVOX engine over HTTP, revolution/laravel-voicevox alone is enough.

composer require revolution/laravel-voicevox

For modes that use FFI, install revolution/voicevox-core too.

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

Requirements

Item	Value
PHP	8.3+
Laravel	12+
Required extension	`ext-zip`
FFI `ext-ffi`	Required for native mode / engine API

On most web servers — including Laravel Cloud — FFI is disabled. Try native mode and the engine API on a local CLI.

Setup steps

Install the package

Install via Composer according to the mode you want. Native mode and the engine API also require VOICEVOX Core for PHP.

Publish the config file

php artisan vendor:publish --tag="voicevox-config"

Configure .env

For client mode only, set VOICEVOX_URL. When using FFI, set VOICEVOX_CORE_PATH.

Install engine resources if needed

Additional resources are required to use /speaker_info or /singer_info.

`config/voicevox.php`

You can review every setting in the configuration reference.

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'),
    ],
];

The minimum `.env`

Client mode only

If you run the official engine on the default http://127.0.0.1:50021, no additional configuration is needed.

VOICEVOX_URL=http://127.0.0.1:50021

Native mode / engine API

VOICEVOX_CORE_PATH=/path/to/voicevox_core/

The contents of VOICEVOX_CORE_PATH are prepared following the steps in VOICEVOX Core for PHP. Check there for placing the library itself, the OpenJTalk dictionary, and the model files.

Enabling FFI

It usually works on the CLI out of the box. To start the Laravel-side engine API locally, enable FFI in php.ini.

ffi.enable=true

FFI’s mechanics and limitations are summarized in PHP FFI.

Installing engine resources

To use resource endpoints such as /speaker_info and /singer_info, install the resource files separately.

php artisan voicevox:install

Under an Orchestra Testbench environment, use this command:

vendor/bin/testbench voicevox:install

Mode entry points

Client Talk

Start the official VOICEVOX engine with Docker and synthesize text.

Client Song

Use Score and Note to synthesize singing voices.

Native Talk

Call VOICEVOX CORE directly with FFI.

Native Song

Learn where singing voice models and sync() fit.

GitHub Copilot

SDK

AI SDK

VOICEVOX

Starter Kits

Feeds and RSS

Middleware

Installation and setup - VOICEVOX for Laravel

What to install

Requirements

Setup steps

`config/voicevox.php`

The minimum `.env`

Client mode only

Native mode / engine API

Enabling FFI

Installing engine resources

Mode entry points

Client Talk

Client Song

Native Talk

Native Song

Reference links

​What to install

​Requirements

​Setup steps

​config/voicevox.php

​The minimum .env

​Client mode only

​Native mode / engine API

​Enabling FFI

​Installing engine resources

​Mode entry points

Client Talk

Client Song

Native Talk

Native Song

​Reference links

What to install

Requirements

Setup steps

`config/voicevox.php`

The minimum `.env`

Client mode only

Native mode / engine API

Enabling FFI

Installing engine resources

Mode entry points

Reference links