Empezar - VOICEVOX for Laravel

Resume los conceptos básicos de VOICEVOX for Laravel, la comparación de los 3 modos, el inicio rápido (modo cliente) y las funciones principales.

VOICEVOX for Laravel es un paquete para usar las funciones de síntesis de voz de VOICEVOX desde Laravel. Puedes generar audio en japonés a partir de texto.

Lo más rápido para empezar es el modo cliente. Si tu entorno admite FFI, puedes ir migrando después al modo nativo o al modo Engine API por fases.

​

Los 3 modos de uso

Modo	Forma de ejecución	FFI	Uso recomendado	Guía
Modo cliente	Conexión HTTP al motor oficial de VOICEVOX	No requerido	Para empezar a probar, entornos Docker, entornos sin FFI	Client Talk / Client Song
Modo nativo	Llama directamente a VOICEVOX CORE con PHP FFI	Requerido	Aceleración, ejecución offline, integración con herramientas CLI	Native Talk / Native Song
Modo Engine API	Laravel expone una API compatible con VOICEVOX	Requerido	Publicar un servidor API, integración con varios clientes	Engine Talk / Engine Song

​

Inicio rápido

Pasos del modo cliente.

1. Instala el paquete

   composer require revolution/laravel-voicevox
   

   Para los detalles, consulta Instalación y configuración.

2. Arranca el motor oficial

   docker pull voicevox/voicevox_engine:cpu-latest
   docker run --rm -p '127.0.0.1:50021:50021' voicevox/voicevox_engine:cpu-latest
   
3. Prueba la síntesis de voz

   use Revolution\Voicevox\Voicevox;
   
   $response = Voicevox::talk('こんにちは、Laravel です。', id: 1)->generate(id: 1);
   $response->storeAs('output.wav');
   

​

Funciones principales

​

Síntesis de voz (Talk)

use Revolution\Voicevox\Client\TalkAudioQuery;
use Revolution\Voicevox\Voicevox;

$response = Voicevox::talk('こんにちは', id: 1)
    ->tap(function (TalkAudioQuery $talk) {
        $talk->audioQuery['speedScale'] = 1.2;
        $talk->audioQuery['pitchScale'] = 0.05;
        $talk->audioQuery['intonationScale'] = 1.5;
        $talk->audioQuery['volumeScale'] = 1.0;
    })
    ->generate(id: 1);

​

Síntesis de voz cantada (Song)

use Revolution\Voicevox\Song\Note;
use Revolution\Voicevox\Song\Score;
use Revolution\Voicevox\Voicevox;

$score = Score::make([
    Note::make(length: 15),
    Note::make(length: Note::len(ticks: 480, bpm: 120), lyric: 'ド', key: 60),
    Note::make(length: Note::len(480, 120), lyric: 'レ', key: 62),
    Note::make(length: Note::len(960, 120), lyric: 'ミ', key: 64),
    Note::make(length: 2),
]);

$response = Voicevox::song($score)->generate(id: 3001);

​

Diccionario de usuario y presets

En modo cliente, usa la facade Voicevox para manipular el diccionario de usuario y los presets del motor oficial.

use Revolution\Voicevox\Voicevox;

$uuid = Voicevox::addWord(
    surface: 'Laravel',
    pronunciation: 'ララベル',
    accentType: 3,
);

$presetId = Voicevox::addPreset([
    '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,
]);

​

Integración con Laravel AI SDK

use Laravel\Ai\Audio;

$audio = Audio::of('こんにちは、Laravel です。')
    ->voice('ずんだもん')
    ->generate();

$audio->storeAs('output.wav');

​

Siguientes pasos

• Instalación y configuración
• Referencia de configuración
• Client Talk
• Client Song
• Modo cliente - Diccionario de usuario
• Modo cliente - Presets
• Native Talk
• Engine Talk
• Modo nativo - Diccionario de usuario
• Modo nativo - Presets
• Integración con AI SDK