Skip to main content

Qué es el diccionario de usuario

Con el diccionario de usuario puedes enseñar a VOICEVOX cómo leer nombres propios y términos técnicos. Las palabras registradas se pronunciarán correctamente al sintetizar el audio.

Resumen

La funcionalidad de diccionario de usuario de Laravel VOICEVOX es una implementación nativa que usa el UserDict de VOICEVOX Core. Los datos del diccionario se persisten en formato JSON en storage/voicevox/user_dict.json.
Como usa un almacenamiento independiente del motor oficial de VOICEVOX, las palabras registradas en Laravel no se reflejan en el motor oficial (y viceversa).

Configuración

Por defecto se guarda en storage/voicevox/user_dict.json. Si quieres usar otra ruta, puedes cambiarla en config/voicevox.php.

Uso básico

Añadir una palabra

Registra palabras con add() del helper dict().

Parámetros

  • surface (obligatorio): forma
  • pronunciation (obligatorio): lectura (solo katakana)
  • accentType (obligatorio): tipo de acento (0 = plano, 1 o más = posición del acento)
  • wordType (opcional): clase gramatical (COMMON_NOUN, PROPER_NOUN, VERB, ADJECTIVE, SUFFIX)
  • priority (opcional): prioridad (por defecto 5)

Tipo de acento

  • 0: acento plano
  • 1: primer mora
  • 2: segundo mora
  • 3: tercer mora

Actualizar una palabra

Eliminar una palabra

Obtener todas las palabras

Importar un diccionario

Exportar el diccionario

Acceso vía Engine API

Si tienes arrancada la Engine API de Laravel VOICEVOX, puedes manipular el diccionario de usuario también por HTTP. No hace fallback al motor oficial; usa el diccionario nativo.

Obtener todas las palabras

Añadir una palabra

Actualizar una palabra

Eliminar una palabra

Importar un diccionario

Si indicas override=true, se elimina todo el diccionario existente antes de importar.

Síntesis de voz tras registrar el diccionario

Las palabras registradas en el diccionario de usuario se consultan automáticamente al sintetizar el audio.

Notas importantes

En pronunciation indica solo katakana. No se pueden usar hiragana ni kanji.
  • El diccionario de usuario de la versión Laravel y el del motor oficial de VOICEVOX se gestionan por separado.
  • Añadir, actualizar y eliminar palabras se guarda inmediatamente en el archivo JSON.
  • Si no sabes qué tipo de acento poner, prueba primero con 0 (plano).

Solución de problemas

La palabra no se refleja

  1. Comprueba los permisos de escritura del directorio de storage.
  2. Comprueba que storage/voicevox/user_dict.json se ha creado correctamente.
  3. Comprueba que la escritura en katakana sea correcta.

No sé dónde está el archivo del diccionario

Quiero resetear el diccionario

Última modificación el 13 de julio de 2026