Skip to main content

What is native mode

Native mode calls VOICEVOX CORE directly through PHP FFI via VOICEVOX Core for PHP. You can synthesize without running the official engine, but FFI and local core library setup are required.
Native mode is not meant for typical web-server deployment. Use local CLI. For FFI constraints, see PHP FFI.

Prerequisites

  1. Complete Installation and Configuration
  2. Complete VOICEVOX Core for PHP setup
  3. Set VOICEVOX_CORE_PATH in .env

Basic usage

Use the talk() helper in native mode.

Style IDs

Use an id included in loaded .vvm models.
Only models listed in core.vvms in config/voicevox.php are available.

Tune Audio Query with tap()

tap() works the same in native mode, but TalkAudioQuery is a different class than client mode.
For the general tap() pattern, see tap() helper and Tappable trait. VOICEVOX for Laravel is a practical implementation example.

Use kana in AquesTalk-like notation

Native mode has no enable_katakana_english, so it is not ideal for reading raw English text directly. Instead, you can pass AquesTalk-like kana with kana().

Difference from client mode

Next pages

Native Song

Use singing models through FFI.

VOICEVOX Core for PHP

Review setup and constraints on the pure PHP wrapper side.
Last modified on May 21, 2026