Saltar al contenido principal

Qué es el modo nativo

El modo nativo llama directamente a VOICEVOX CORE desde PHP FFI a través de VOICEVOX Core for PHP. Puedes sintetizar sin arrancar el motor oficial, pero necesitas configurar FFI y la biblioteca local.
El modo nativo no está pensado para servidores web. Úsalo en un CLI local. Las restricciones de FFI se explican también en PHP FFI.

Preparación

  1. Haber completado Instalación y configuración
  2. Haber completado la configuración de VOICEVOX Core for PHP
  3. Tener configurado VOICEVOX_CORE_PATH en .env

Uso básico

En modo nativo se usa el helper talk().

Indicar el style ID

En id indica un style ID incluido en los .vvm ya cargados.
Solo se pueden usar los modelos incluidos en core.vvms de config/voicevox.php.

Ajustar el audio query con tap()

En modo nativo, tap() se usa igual. Ojo: TalkAudioQuery es una clase distinta de la del modo cliente.
El propio patrón de tap() está recogido en Helper tap() y trait Tappable. VOICEVOX for Laravel es un ejemplo práctico de ese patrón.

Usar kana con notación tipo AquesTalk

Como el modo nativo no dispone de enable_katakana_english, no encaja bien para leer directamente entradas mezcladas con inglés. En su lugar puedes usar kana() para pasar directamente kana en notación tipo AquesTalk.

Síntesis de voz en streaming

stream() sigue la misma especificación que /streaming_synthesis de VOICEVOX Engine 0.26.0 y devuelve un TalkStream que emite el WAV en orden desde el principio. Solo se admiten estilos de tipo streaming_talk (formato VVM v2).
Si startOffset es mayor o igual que la duración del audio, stream() lanza una InvalidArgumentException. Internamente renderiza el AudioFeature de VOICEVOX Core segmento a segmento. Para más detalles, consulta Uso de VOICEVOX Core for PHP.

Diferencias con el modo cliente

Siguientes páginas

Nativo Song

Usa el modelo de voz cantada vía FFI.

VOICEVOX Core for PHP

Revisa la configuración y las restricciones del wrapper PHP puro.
Última modificación el 2 de noviembre de 2026