VOICEVOX Core for PHP

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.

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

Muévelo a una ubicación permanente

mv voicevox_core ~/.local/voicevox_core

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

GitHub: invokable/voicevox-core-php
VOICEVOX CORE: VOICEVOX/voicevox_core

GitHub Copilot

SDK

AI SDK

VOICEVOX

Starter kits

Feeds y RSS

Middleware

Resumen

Requisitos

Instalación

Configuración de la biblioteca

Alternativa: indicarlo por variable de entorno

Documentación

Uso

Referencia de API

Enlaces de referencia

​Resumen

​Requisitos

​Instalación

​Configuración de la biblioteca

​Alternativa: indicarlo por variable de entorno

​Documentación

Uso

Referencia de API

​Enlaces de referencia

Resumen

Requisitos

Instalación

Configuración de la biblioteca

Alternativa: indicarlo por variable de entorno

Documentación

Enlaces de referencia