Skip to main content

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 en storage/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 en storage/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 con add() del helper preset().

Obtener todos los presets

Buscar un preset

Actualizar un preset

Eliminar un preset

Síntesis de voz con presets

Utiliza el helper talk() 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.
Con presets aplicados, el flujo normal de síntesis es el mismo. Solo se sustituyen los valores por defecto del AudioQuery con los del preset.

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

Los presets de la versión Laravel y los del motor oficial de VOICEVOX se gestionan por separado. Añadir, actualizar y eliminar se guarda inmediatamente en el archivo JSON.
  • Si indicas 0 como ID del preset, se autonumera con un ID libre.
  • Incluye tanto speaker_uuid (UUID string) como style_id (entero) en el preset.

Solución de problemas

El preset no se guarda

  1. Comprueba los permisos de escritura del directorio de storage.
  2. Comprueba que storage/voicevox/presets.json se ha creado correctamente.

No sé dónde está el archivo de presets

Quiero resetear los presets

Última modificación el 13 de julio de 2026