Qué son los presets
Con la funcionalidad de presets puedes guardar combinaciones habituales de parámetros de síntesis de voz y reutilizarlas.Al gestionar de forma conjunta velocidad, tono, entonación, etc., es más fácil mantener una calidad coherente aunque generes varios audios.
Resumen
La funcionalidad de presets de Laravel VOICEVOX es una implementación nativa que usa VOICEVOX Core. Los datos de los presets se persisten en formato JSON enstorage/voicevox/presets.json.
Usa un almacenamiento independiente del motor oficial de VOICEVOX, así que los presets creados en Laravel no se reflejan en el motor oficial (y viceversa).
Configuración
Por defecto se guardan enstorage/voicevox/presets.json. Si quieres usar otra ruta, puedes cambiarla en config/voicevox.php.
Estructura del preset
Los presets tienen la siguiente estructura.Uso básico
Crear un preset
Puedes crear presets conadd() del helper preset().
Obtener todos los presets
Buscar un preset
Actualizar un preset
Eliminar un preset
Síntesis de voz con presets
Utiliza el helpertalk() o el endpoint /audio_query_from_preset de la Engine API.
Helper talk()
Indica el ID del preset en talk(preset:). En ese caso se ignora el style ID habitual.
Acceso vía Engine API
Si tienes arrancada la Engine API de Laravel VOICEVOX, puedes manipular los presets por HTTP.Obtener todos los presets
Añadir un preset
Actualizar un preset
Eliminar un preset
Generar audio query con un preset
Detalle de parámetros
speedScale: 0.5 a 2.0 (velocidad)pitchScale: -0.15 a 0.15 (tono)intonationScale: 0.0 a 2.0 (entonación)volumeScale: 0.0 a 2.0 (volumen)prePhonemeLength: 0.0 a 1.5 (silencio inicial, en segundos)postPhonemeLength: 0.0 a 1.5 (silencio final, en segundos)
Notas importantes
- Si indicas
0como ID del preset, se autonumera con un ID libre. - Incluye tanto
speaker_uuid(UUID string) comostyle_id(entero) en el preset.
Solución de problemas
El preset no se guarda
- Comprueba los permisos de escritura del directorio de storage.
- Comprueba que
storage/voicevox/presets.jsonse ha creado correctamente.