Skip to main content

Wat zijn presets

Met de presetfunctie kun je veelgebruikte combinaties van spraaksyntheseparameters opslaan en hergebruiken.
Door spreeksnelheid, toonhoogte, intonatie en dergelijke gezamenlijk te beheren, is het makkelijker om een consistente kwaliteit te behouden wanneer je meerdere audiofragmenten genereert.

Overzicht

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

Configuratie

Standaard worden presets opgeslagen in storage/voicevox/presets.json. Wil je een ander pad gebruiken, dan kun je dat wijzigen in config/voicevox.php.

Structuur van een preset

Een preset heeft de volgende structuur.

Basisgebruik

Een preset aanmaken

Met add() van de preset()-helper maak je een preset aan.

Alle presets ophalen

Een preset opzoeken

Een preset bijwerken

Een preset verwijderen

Spraaksynthese met presets

Gebruik de talk()-helper of het /audio_query_from_preset-endpoint van de Engine API.

De talk()-helper

Geef een preset-ID op via talk(preset:). Het gewone stijl-ID wordt dan genegeerd.
Ook bij het toepassen van een preset blijft de normale spraaksyntheseflow gelijk. Alleen de waarden van de standaard AudioQuery worden door de preset vervangen.

Toegang via de Engine API

Als je de Engine API van Laravel VOICEVOX draait, kun je presets via HTTP beheren.

Alle presets ophalen

Een preset toevoegen

Een preset bijwerken

Een preset verwijderen

Een audioquery genereren met een preset

Parameterdetails

  • speedScale: 0.5 – 2.0 (spreeksnelheid)
  • pitchScale: -0.15 – 0.15 (toonhoogte)
  • intonationScale: 0.0 – 2.0 (intonatie)
  • volumeScale: 0.0 – 2.0 (volume)
  • prePhonemeLength: 0.0 – 1.5 (stilte aan het begin, in seconden)
  • postPhonemeLength: 0.0 – 1.5 (stilte aan het einde, in seconden)

Aandachtspunten

De presets van de Laravel-versie en de presets van de officiële VOICEVOX-engine worden apart beheerd. Toevoegingen, wijzigingen en verwijderingen worden direct naar het JSON-bestand opgeslagen.
  • Als je 0 opgeeft als preset-ID, wordt automatisch een ongebruikt ID toegewezen.
  • Neem in een preset zowel speaker_uuid (UUID-string) als style_id (integer) op.

Probleemoplossing

Presets worden niet opgeslagen

  1. Controleer de schrijfrechten van de storage-directory
  2. Controleer of storage/voicevox/presets.json correct is aangemaakt

Je weet niet waar het presetbestand staat

Presets resetten

Laatst gewijzigd op 6 september 2026