Naar hoofdinhoud gaan

Wat is de native modus

In de native modus roep je VOICEVOX CORE rechtstreeks aan via PHP FFI, via VOICEVOX Core for PHP. Je kunt synthetiseren zonder de officiële engine te starten, maar je moet wel FFI en de lokale bibliotheek opzetten.
De native modus is niet bedoeld voor webservers. Gebruik hem in een lokale CLI. De beperkingen van FFI worden ook uitgelegd in PHP FFI.

Voorbereiding

  1. Je hebt Installatie en configuratie afgerond
  2. Je hebt de setup van VOICEVOX Core for PHP afgerond
  3. Je hebt VOICEVOX_CORE_PATH ingesteld in .env

Basisgebruik

In de native modus gebruik je de talk()-helper.

Een stijl-ID opgeven

Bij id geef je een stijl-ID op dat voorkomt in de geladen .vvm.
Alleen modellen die zijn opgenomen in core.vvms in config/voicevox.php zijn bruikbaar.

De Audio Query aanpassen met tap()

Ook in de native modus gebruik je tap() op dezelfde manier. Let wel: TalkAudioQuery is een andere klasse dan in de clientmodus.
Het tap()-patroon zelf wordt behandeld in De tap()-helper en de Tappable-trait. VOICEVOX for Laravel is daarvan een praktijkvoorbeeld.

Kana in AquesTalk-achtige notatie gebruiken

Omdat de native modus geen enable_katakana_english heeft, is hij niet geschikt om invoer met Engels erin direct voor te lezen. In plaats daarvan kun je kana() gebruiken, waarmee je kana in AquesTalk-achtige notatie direct doorgeeft.

Streaming spraaksynthese

stream() volgt dezelfde specificatie als /streaming_synthesis in VOICEVOX Engine 0.26.0 en retourneert een TalkStream die de WAV vanaf het begin op volgorde uitvoert. Alleen stijlen van het type streaming_talk (VVM v2-formaat) worden ondersteund.
Als startOffset groter dan of gelijk aan de audiolengte is, gooit stream() een InvalidArgumentException. Intern rendert het de AudioFeature van VOICEVOX Core per segment. Zie Gebruik van VOICEVOX Core for PHP voor details.

Verschillen met de clientmodus

Volgende pagina’s

Native Song

Werk met zangmodellen via FFI.

VOICEVOX Core for PHP

Bekijk de setup en beperkingen van de pure PHP-wrapper.
Laatst gewijzigd op 2 november 2026