Engine API Mode: Talk (Text-to-Speech) - VOICEVOX for Laravel

What is engine API mode

Engine API mode provides a VOICEVOX Engine-compatible HTTP API inside your Laravel app. Start your app with php artisan serve --port=50513, then use endpoints like /audio_query and /synthesis directly.

Prerequisites

Set up VOICEVOX Core for PHP

Follow Installation and Configuration to prepare voicevox-core-php and core libraries.

Configure environment and enable FFI

VOICEVOX_CORE_PATH=/path/to/voicevox_core/

ffi.enable=true

Install character resources

php artisan voicevox:install

Start Laravel engine

php artisan serve --port=50513

Default URL is http://127.0.0.1:50513.

About port 50513

The official VOICEVOX engine uses port 50021 by default. Port 50513 is chosen so you can run the Laravel engine and the official engine at the same time. You are free to use any other port — just pass a different --port value, such as --port=8000.

The official engine automatically picks the next available port (50022, 50023, …) when 50021 is busy. php artisan serve does the same when no --port is given (8001, 8002, …), but it fails to start if the specified port is already in use. Choose a fixed port that is unlikely to conflict with other services. Port 50513 is one example chosen to avoid collisions with both the official VOICEVOX engine (50021) and common Laravel ports.

Generate talk audio

1. Create `audio_query`

curl -s -X POST "http://127.0.0.1:50513/audio_query?speaker=1&text=I%20love%20Laravel" \
  -H "Content-Type: application/json" \
  > audio_query.json

2. Synthesize with `synthesis`

curl -s -X POST "http://127.0.0.1:50513/synthesis?speaker=1" \
  -H "Content-Type: application/json" \
  -d @audio_query.json \
  > talk.wav

Use from Laravel client mode

Point client-mode URL to the Laravel engine API.

// config/voicevox.php
'client' => [
    'url' => env('VOICEVOX_URL', 'http://127.0.0.1:50513'),
],

use Revolution\Voicevox\Voicevox;

$response = Voicevox::talk('I love Laravel', id: 1)
    ->generate(id: 1);

$response->storeAs('engine', 'talk.wav');

Enable/disable and fallback

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

Unsupported endpoints like cancellable_synthesis and multi_synthesis can fall back to official engine.

If you rely on fallback, run official VOICEVOX engine at VOICEVOX_ENGINE_FALLBACK_URL.

Talk endpoint support

Endpoint	Laravel engine	Fallback	Notes
`POST /audio_query`	✅	✅	`enable_katakana_english` unsupported
`POST /accent_phrases`	✅	✅	`enable_katakana_english` unsupported
`POST /synthesis`	✅	✅
`POST /mora_data`	✅	✅
`POST /mora_length`	✅	✅
`POST /mora_pitch`	✅	✅
`GET /speakers`	✅	✅
`GET /speaker_info`	✅	✅	Requires resource install
`POST /cancellable_synthesis`	❌	✅	Fallback only
`POST /multi_synthesis`	❌	✅	Fallback only

OpenAI-compatible TTS endpoint

POST /v1/audio/speech accepts the same request format as the OpenAI speech API. Changing the Base URL is all you need to connect any OpenAI-compatible tool — including Laravel AI SDK.

curl -s -X POST "http://127.0.0.1:50513/v1/audio/speech" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "voicevox",
    "input": "I love Laravel",
    "voice": "shimmer"
  }' \
  > talk.wav

Parameters

Parameter	Description
`input`	Text to synthesize (max 4096 characters)
`voice`	Style ID (integer), character alias (`ずんだもん`, `四国めたん`, etc.), or OpenAI voice name (`alloy`, `shimmer`, etc.)
`speed`	Playback speed applied as `speedScale` (0.25–4.0, default 1.0)
`response_format`	Always returns wav. The value is ignored
Other parameters	Ignored

OpenAI voice names (alloy, shimmer, etc.) are provisional mappings. There is no authoritative definition of how each OpenAI voice should correspond to a VOICEVOX character, so these are convenience assignments for compatibility. Using VOICEVOX character aliases (ずんだもん, 四国めたん/ノーマル, etc.) is recommended.

Engine API: Song

Use sing_frame_audio_query and frame_synthesis endpoints.

Laravel AI SDK Integration

Configure VOICEVOX with Audio facade workflows.

GitHub Copilot

SDK

AI SDK

VOICEVOX

Starter Kits

Feeds and RSS

Middleware

Engine API Mode: Talk (Text-to-Speech) - VOICEVOX for Laravel

What is engine API mode

Prerequisites

Start Laravel engine

About port 50513

Generate talk audio

1. Create `audio_query`

2. Synthesize with `synthesis`

Use from Laravel client mode

Enable/disable and fallback

Talk endpoint support

OpenAI-compatible TTS endpoint

Parameters

Next pages

Engine API: Song

Laravel AI SDK Integration

​What is engine API mode

​Prerequisites

​Start Laravel engine

​About port 50513

​Generate talk audio

​1. Create audio_query

​2. Synthesize with synthesis

​Use from Laravel client mode

​Enable/disable and fallback

​Talk endpoint support

​OpenAI-compatible TTS endpoint

​Parameters

​Next pages

Engine API: Song

Laravel AI SDK Integration

What is engine API mode

Prerequisites

Start Laravel engine

About port 50513

Generate talk audio

1. Create `audio_query`

2. Synthesize with `synthesis`

Use from Laravel client mode

Enable/disable and fallback

Talk endpoint support

OpenAI-compatible TTS endpoint

Parameters

Next pages