VOICEVOX for Laravel

Overview

revolution/laravel-voicevox is a package for working with VOICEVOX from Laravel. You can use both the client mode, which connects to the official engine over HTTP, and the native mode, which synthesizes directly through PHP FFI in combination with VOICEVOX Core for PHP — all with the same Laravel-native style.

If you’d like a primer on FFI first, see PHP FFI. For setting up the core library itself, see VOICEVOX Core for PHP and usage.

Feature matrix

Feature	Supported	Description
VOICEVOX client	✅	Accesses the official VOICEVOX engine API over HTTP. FFI is not required.
VOICEVOX core	✅	Uses the VOICEVOX CORE dynamic library via VOICEVOX Core for PHP.
Laravel style	✅	Facades, helpers, `config/voicevox.php`, and `.env` for a Laravel-native experience.
Laravel AI SDK integration	✅	Usable from the Laravel AI SDK’s Audio workflow.
VOICEVOX engine	⚠️	Provides a VOICEVOX-compatible API inside your Laravel app. Unsupported parts fall back to the official engine.
VOICEVOX engine / OpenAI-compatible TTS API	✅	Like the AI SDK, `/v1/audio/speech` `voice` supports style IDs and aliases such as “Zundamon”.
VOICEVOX editor	⚠️	A song-focused macOS app was developed, but there are no plans to publish or distribute it on the App Store. Some day, if the code is published on GitHub, you’ll be able to build it with Xcode.

Requirements

PHP 8.3+
Laravel 12+
ext-zip
ext-ffi when using native mode / the engine API
Local CLI environment

In common web server environments — including Laravel Cloud — FFI is usually disabled, so treat native mode and the engine API as local-CLI only.

Mode list

Mode	How it runs	FFI	Primary use	Guide
Client Talk	HTTP request to the official engine	Not required	Text-to-speech synthesis	client-talk
Client Song	HTTP request to the official engine	Not required	Singing voice synthesis	client-song
Native Talk	Calls VOICEVOX CORE directly via FFI	Required	Local text-to-speech synthesis	native-talk
Native Song	Calls VOICEVOX CORE directly via FFI	Required	Local singing voice synthesis	native-song
Engine API	Provides a compatible API inside the Laravel app	Required	Embedding a VOICEVOX-compatible API	installation

Why `tap()` fits well

This package returns an Audio Query object right after talk() / song(), letting you insert an adjustment phase before generate(). tap() therefore reads naturally as “adjust the query without changing the return value”.

use Revolution\Voicevox\Client\TalkAudioQuery;
use Revolution\Voicevox\Voicevox;

$response = Voicevox::talk('You can tweak with tap, na no da', id: 1)
    ->tap(function (TalkAudioQuery $talk) {
        $talk->audioQuery['speedScale'] = 1.2;
    })
    ->generate(id: 1);

For Talk, you can tweak speedScale, pitchScale, and so on.
For Song, you can recompute F0 and volume with sync().
It chains cleanly into the VoicevoxResponse that generate() returns.

The idea behind tap() itself is summarized in The tap() helper and the Tappable trait. This package is an especially clear practical example.

Documentation

Installation

Client-only setup, FFI-based setup, publishing the config file, and preparing engine resources.

Client Talk

Get started with text-to-speech via the official VOICEVOX engine.

Client Song

Compose Score and Note to synthesize singing voices.

Native Talk

Synthesize locally with PHP FFI and VOICEVOX CORE.

Native Song

Use singing voice models directly through FFI.

VOICEVOX Core for PHP

Set up the core library and use it from pure PHP.

Reference links

GitHub: invokable/laravel-voicevox
VOICEVOX Core for PHP: /en/packages/voicevox-core-php
VOICEVOX Core for PHP usage: /en/packages/voicevox-core-php/usage
PHP FFI: /en/advanced/ffi
tap() helper: /en/advanced/tap
Official VOICEVOX engine: VOICEVOX/voicevox_engine

GitHub Copilot

SDK

AI SDK

VOICEVOX

Starter Kits

Feeds and RSS

Middleware

Overview

Feature matrix

Requirements

Mode list

Why `tap()` fits well

Documentation

Installation

Client Talk

Client Song

Native Talk

Native Song

VOICEVOX Core for PHP

Reference links

​Overview

​Feature matrix

​Requirements

​Mode list

​Why tap() fits well

​Documentation

Installation

Client Talk

Client Song

Native Talk

Native Song

VOICEVOX Core for PHP

​Reference links

Overview

Feature matrix

Requirements

Mode list

Why `tap()` fits well

Documentation

Reference links