Skip to main content

Wat is het gebruikerswoordenboek

Met het gebruikerswoordenboek kun je VOICEVOX de uitspraak van eigennamen en vaktermen aanleren. Geregistreerde woorden worden bij spraaksynthese met de juiste uitspraak voorgelezen.

Overzicht

De gebruikerswoordenboekfunctie van Laravel VOICEVOX is een native implementatie die gebruikmaakt van de UserDict van VOICEVOX Core. De woordenboekgegevens worden in JSON-formaat opgeslagen in storage/voicevox/user_dict.json.
Omdat er een opslag wordt gebruikt die losstaat van de officiële VOICEVOX-engine, worden woorden die je aan de Laravel-kant registreert niet doorgevoerd naar de officiële engine (en andersom evenmin).

Configuratie

Standaard wordt het woordenboek opgeslagen in storage/voicevox/user_dict.json. Wil je een ander pad gebruiken, dan kun je dat wijzigen in config/voicevox.php.

Basisgebruik

Een woord toevoegen

Met add() van de dict()-helper registreer je een woord.

Parameters

  • surface (verplicht): schrijfwijze
  • pronunciation (verplicht): uitspraak (alleen katakana)
  • accentType (verplicht): accenttype (0 = vlak, 1 of hoger = accentpositie)
  • wordType (optioneel): woordsoort (COMMON_NOUN, PROPER_NOUN, VERB, ADJECTIVE, SUFFIX)
  • priority (optioneel): prioriteit (standaard 5)

Accenttypen

  • 0: vlak accent
  • 1: eerste mora
  • 2: tweede mora
  • 3: derde mora

Een woord bijwerken

Een woord verwijderen

Alle woorden ophalen

Een woordenboek importeren

Een woordenboek exporteren

Toegang via de Engine API

Als je de Engine API van Laravel VOICEVOX draait, kun je het gebruikerswoordenboek ook via HTTP beheren. Er wordt niet teruggevallen op de officiële engine; het native woordenboek wordt gebruikt.

Alle woorden ophalen

Een woord toevoegen

Een woord bijwerken

Een woord verwijderen

Een woordenboek importeren

Als je override=true opgeeft, wordt het bestaande woordenboek eerst volledig verwijderd voordat er wordt geïmporteerd.

Spraaksynthese na registratie in het woordenboek

Woorden die in het gebruikerswoordenboek zijn geregistreerd, worden bij spraaksynthese automatisch geraadpleegd.

Aandachtspunten

Geef bij pronunciation uitsluitend katakana op. Hiragana en kanji zijn niet toegestaan.
  • Het gebruikerswoordenboek van de Laravel-versie en dat van de officiële VOICEVOX-engine worden apart beheerd.
  • Toevoegingen, wijzigingen en verwijderingen van woorden worden direct naar het JSON-bestand opgeslagen.
  • Weet je het accenttype niet, probeer dan eerst 0 (vlak).

Probleemoplossing

Woorden worden niet toegepast

  1. Controleer de schrijfrechten van de storage-directory
  2. Controleer of storage/voicevox/user_dict.json correct is aangemaakt
  3. Controleer of de katakana-schrijfwijze klopt

Je weet niet waar het woordenboekbestand staat

Het woordenboek resetten

Laatst gewijzigd op 6 september 2026