Cos’è un preset
La funzionalità dei preset permette di salvare e riutilizzare combinazioni di parametri di sintesi vocale usate frequentemente.
Gestire insieme velocità di parlata, tono, intonazione, ecc. rende più facile mantenere una qualità coerente anche quando generi più audio.
Panoramica
La funzionalità dei preset di Laravel VOICEVOX è un’implementazione nativa che utilizza VOICEVOX Core. I dati dei preset vengono persistiti in formato JSON in storage/voicevox/presets.json.
Poiché usa uno storage indipendente dal VOICEVOX Engine ufficiale, i preset creati lato Laravel non si riflettono lato engine ufficiale (e viceversa).
Configurazione
Per impostazione predefinita vengono salvati in storage/voicevox/presets.json. Se vuoi usare un percorso diverso, puoi cambiarlo in config/voicevox.php.
// config/voicevox.php
return [
'core' => [
'presets' => storage_path('voicevox/presets.json'),
],
];
Struttura di un preset
Un preset ha la seguente struttura.
[
'id' => 1, // ID del preset (intero, numerato automaticamente)
'name' => 'ゆっくり', // Nome del preset
'speaker_uuid' => 'uuid', // UUID dello speaker (stringa)
'style_id' => 1, // ID dello stile (intero)
'speedScale' => 0.8, // Velocità (0.5 - 2.0)
'pitchScale' => 0.0, // Tono (-0.15 - 0.15)
'intonationScale' => 1.0, // Intonazione (0.0 - 2.0)
'volumeScale' => 1.0, // Volume (0.0 - 2.0)
'prePhonemeLength' => 0.1, // Silenzio iniziale (0.0 - 1.5)
'postPhonemeLength' => 0.1, // Silenzio finale (0.0 - 1.5)
]
Uso di base
Creazione di un preset
Puoi creare un preset con add() dell’helper preset().
use function Revolution\Voicevox\preset;
$id = preset()->add([
'id' => 0, // se specifichi 0 viene assegnato automaticamente
'name' => 'ゆっくり丁寧',
'speaker_uuid' => '7ffcb7ce-00ec-4bdc-82cd-45a8889e43ff',
'style_id' => 1,
'speedScale' => 0.8,
'pitchScale' => 0.0,
'intonationScale' => 1.2,
'volumeScale' => 1.0,
'prePhonemeLength' => 0.1,
'postPhonemeLength' => 0.1,
]);
// Restituisce l'ID assegnato automaticamente
echo $id; // esempio: 1
Recupero di tutti i preset
use function Revolution\Voicevox\preset;
$presets = preset()->all();
Ricerca di un preset
use function Revolution\Voicevox\preset;
$preset = preset()->find(1);
if ($preset !== null) {
echo $preset['name']; // "ゆっくり丁寧"
}
Aggiornamento di un preset
use function Revolution\Voicevox\preset;
preset()->update([
'id' => 1,
'name' => 'ゆっくりはっきり',
'speaker_uuid' => '7ffcb7ce-00ec-4bdc-82cd-45a8889e43ff',
'style_id' => 1,
'speedScale' => 0.7,
'pitchScale' => 0.0,
'intonationScale' => 1.5,
'volumeScale' => 1.0,
'prePhonemeLength' => 0.1,
'postPhonemeLength' => 0.1,
]);
Eliminazione di un preset
use function Revolution\Voicevox\preset;
preset()->delete(1);
Sintesi vocale con un preset
Usa l’helper talk() o l’endpoint /audio_query_from_preset dell’API Engine.
Helper talk()
Specifica l’ID del preset in talk(preset:). In tal caso il normale ID di stile viene ignorato.
use function Revolution\Voicevox\talk;
$response = talk('プリセットを使うのだ', preset: 1)->generate(id: 1);
Anche quando applichi un preset, il flusso di sintesi vocale rimane lo stesso. Cambiano solo i valori dell’AudioQuery predefinito, sostituiti dal preset.
Accesso tramite API Engine
Quando è avviata l’API Engine di Laravel VOICEVOX, puoi gestire i preset via HTTP.
Recupero di tutti i preset
curl http://localhost:50513/presets
Aggiunta di un preset
curl -X POST http://localhost:50513/add_preset \
-H "Content-Type: application/json" \
-d '{
"id": 0,
"name": "ゆっくり丁寧",
"speaker_uuid": "7ffcb7ce-00ec-4bdc-82cd-45a8889e43ff",
"style_id": 1,
"speedScale": 0.8,
"pitchScale": 0.0,
"intonationScale": 1.2,
"volumeScale": 1.0,
"prePhonemeLength": 0.1,
"postPhonemeLength": 0.1
}'
Aggiornamento di un preset
curl -X POST http://localhost:50513/update_preset \
-H "Content-Type: application/json" \
-d '{
"id": 1,
"name": "ゆっくりはっきり",
"speaker_uuid": "7ffcb7ce-00ec-4bdc-82cd-45a8889e43ff",
"style_id": 1,
"speedScale": 0.7,
"pitchScale": 0.0,
"intonationScale": 1.5,
"volumeScale": 1.0,
"prePhonemeLength": 0.1,
"postPhonemeLength": 0.1
}'
Eliminazione di un preset
curl -X POST http://localhost:50513/delete_preset \
-H "Content-Type: application/json" \
-d '{"id": 1}'
Generare una query audio da un preset
curl -X POST "http://localhost:50513/audio_query_from_preset?text=こんにちは&preset_id=1"
Dettagli dei parametri
speedScale: da 0.5 a 2.0 (velocità)pitchScale: da -0.15 a 0.15 (tono)intonationScale: da 0.0 a 2.0 (intonazione)volumeScale: da 0.0 a 2.0 (volume)prePhonemeLength: da 0.0 a 1.5 (silenzio iniziale, in secondi)postPhonemeLength: da 0.0 a 1.5 (silenzio finale, in secondi)
Note
I preset della versione Laravel e quelli del VOICEVOX Engine ufficiale sono gestiti separatamente. Le operazioni di aggiunta, aggiornamento ed eliminazione vengono salvate immediatamente nel file JSON.
- Se specifichi
0 come ID del preset, viene assegnato automaticamente un ID non usato.
- Il preset deve includere sia
speaker_uuid (stringa UUID) sia style_id (intero).
Risoluzione dei problemi
Il preset non viene salvato
- Controlla i permessi di scrittura sulla directory di storage
- Verifica che
storage/voicevox/presets.json sia stato creato correttamente
Non trovi il percorso del file dei preset
$path = config('voicevox.core.presets');
echo $path;
Reimpostare i preset
rm storage/voicevox/presets.json
$path = config('voicevox.core.presets');
if (file_exists($path)) {
unlink($path);
}
