Skip to main content

What is native mode?

Native mode uses VOICEVOX Core for PHP to call VOICEVOX CORE directly through PHP FFI. You can synthesize without starting the official engine, but you need FFI and a local library setup.
Native mode is not intended for web servers. Use it from a local CLI. FFI limitations are also covered in PHP FFI.

Prerequisites

  1. Complete installation and setup.
  2. Complete the setup for VOICEVOX Core for PHP.
  3. Set VOICEVOX_CORE_PATH in .env.

Basic usage

In native mode, use the talk() helper.

Specifying a style ID

Set id to a style ID contained in a loaded .vvm.
Only models included in core.vvms in config/voicevox.php can be used.

Adjusting the Audio Query with tap()

tap() works the same way in native mode. Note, though, that TalkAudioQuery is a different class from the one in client mode.
The tap() pattern itself is summarized in The tap() helper and the Tappable trait. VOICEVOX for Laravel is a practical example of it.

Using AquesTalk-style kana

Native mode has no enable_katakana_english, so it isn’t suited to reading input that mixes in English. Use kana() instead to pass AquesTalk-style kana directly.

Differences from client mode

Next pages

Native Song

Work with singing voice models through FFI.

VOICEVOX Core for PHP

Set up the pure PHP wrapper and understand its constraints.
Last modified on August 2, 2026