Saltar al contenido principal

​
Resumen

revolution/voicevox-core es un paquete Pure PHP que envuelve con PHP FFI la biblioteca dinámica C de VOICEVOX CORE. VOICEVOX es un motor de síntesis de voz (TTS) en japonés de alta calidad, y con este paquete puedes hacer síntesis de voz directamente desde PHP.
Si quieres repasar antes el mecanismo y las restricciones del propio PHP FFI, consulta PHP FFI.
Si lo vas a usar desde una app Laravel, lee también VOICEVOX for Laravel, donde se organizan las diferencias entre el modo cliente y el modo nativo.
Como PHP FFI suele estar deshabilitado en entornos de servidor web (FPM, etc.) (ffi.enable=false), este paquete está pensado para uso en CLI local.

​
Requisitos

  • PHP 8.3+
  • Que la extensión ext-ffi esté habilitada
  • VOICEVOX CORE 0.16+

​
Instalación

composer require revolution/voicevox-core

​
Configuración de la biblioteca

Para usar este paquete se necesitan la biblioteca dinámica de VOICEVOX CORE (.so / .dylib), la biblioteca ONNX Runtime y el diccionario OpenJTalk.
1

Descarga voicevox_core

Descarga el downloader adecuado a tu SO y arquitectura desde voicevox_core releases y ejecútalo. Al ejecutarlo se crea el directorio voicevox_core en el directorio actual.Estructura del directorio que se crea:
voicevox_core/
├── dict/open_jtalk_dic_*/     # Diccionario OpenJTalk
├── c_api/lib/                 # Biblioteca dinámica (.so, .dylib)
├── models/vvms/               # Archivos de modelo de voz (.vvm)
└── onnxruntime/               # Biblioteca ONNX Runtime
2

Muévelo a una ubicación permanente

mv voicevox_core ~/.local/voicevox_core
3

Crea enlaces simbólicos (recomendado)

Crea enlaces simbólicos para que la biblioteca se encuentre automáticamente.
En ln -s utiliza siempre rutas absolutas.
macOS:
# Sustituye [VOICEVOX_CORE_DIR] por la ruta absoluta de voicevox_core
ln -s [VOICEVOX_CORE_DIR]/libvoicevox_core.dylib /usr/local/lib/libvoicevox_core.dylib
Si no se puede cargar desde /usr/local/lib/, configura DYLD_FALLBACK_LIBRARY_PATH en .zshrc, por ejemplo:
export DYLD_FALLBACK_LIBRARY_PATH="$HOME/lib:/usr/local/lib:/usr/lib"
Linux:
ln -s [VOICEVOX_CORE_DIR]/libvoicevox_core.so /usr/local/lib/libvoicevox_core.so

​
Alternativa: indicarlo por variable de entorno

Si no puedes crear enlaces simbólicos, configura la ruta completa al archivo de la biblioteca en la variable de entorno VOICEVOX_CORE_LIB_PATH: 
export VOICEVOX_CORE_LIB_PATH=/path/to/libvoicevox_core.dylib

export VOICEVOX_CORE_LIB_PATH="$HOME/.local/voicevox_core/c_api/lib/libvoicevox_core.dylib"
Si en macOS no se puede cargar ni siquiera con DYLD_FALLBACK_LIBRARY_PATH, configúralo con VOICEVOX_CORE_LIB_PATH.

​
Documentación

Uso

Uso básico de síntesis de voz y ejemplos de código.

Referencia de API

Referencia detallada de todas las clases, métodos y enums.

​
Enlaces de referencia

Última modificación el 13 de julio de 2026

Temas relacionados

VOICEVOX Core for PHP