사용법 - VOICEVOX Core for PHP

<?php

require __DIR__ . '/vendor/autoload.php';

use Revolution\Voicevox\Core\Enums\AccelerationMode;
use Revolution\Voicevox\Core\Onnxruntime;
use Revolution\Voicevox\Core\OpenJtalk;
use Revolution\Voicevox\Core\Synthesizer;
use Revolution\Voicevox\Core\VoiceModelFile;

// voicevox_core 설치 위치에 맞게 경로를 변경하세요
$voicevoxCoreDir = getenv('HOME') . '/.local/voicevox_core';
// 권장 ONNX Runtime은 1.23.2입니다. 설치된 버전과 맞지 않는 경우 파일명을 직접 지정하세요
$onnxruntimeFilename = $voicevoxCoreDir . '/onnxruntime/lib/' . Onnxruntime::libRecommendedVersionedFilename();
$dictDir = $voicevoxCoreDir . '/dict/open_jtalk_dic_utf_8-1.11';
$vvmPath  = $voicevoxCoreDir . '/models/vvms/0.vvm';

// 합성할 텍스트와 스타일 ID
$text    = 'この音声は、ボイスボックスを使用して、出力されています。';
$styleId = 0;
$outPath = './output.wav';

// 초기화
$onnxruntime = Onnxruntime::loadOnce($onnxruntimeFilename);
$openJtalk   = new OpenJtalk($dictDir);
$synthesizer = new Synthesizer($onnxruntime, $openJtalk, AccelerationMode::Auto);

// 음성 모델 로드
$model = VoiceModelFile::open($vvmPath);
$synthesizer->loadVoiceModel($model);

// 음성 합성
$audioQuery = $synthesizer->createAudioQuery($text, $styleId);
$wav        = $synthesizer->synthesis($audioQuery, $styleId);

file_put_contents($outPath, $wav);
echo 'Wrote ' . $outPath . PHP_EOL;

php talk.php

$wav = $synthesizer->tts($text, $styleId);
file_put_contents('./output.wav', $wav);

// ttsFromKana를 사용할 경우
$wav = $synthesizer->ttsFromKana("コノオンセイワ'、ボイスボックスオ'/シヨーシテ'、シュツリョクサレテイマ'ス。", $styleId);
file_put_contents('./output.wav', $wav);

use Revolution\Voicevox\Core\UserDict;
use Revolution\Voicevox\Core\Enums\UserDictWordType;

$userDict = new UserDict();
$uuid = $userDict->addWord(
    surface: 'ボイボ',
    pronunciation: 'ボイボ',
    accentType: 0,
    wordType: UserDictWordType::ProperNoun,
    priority: 10,
);

// 사전 저장
$userDict->save('./mydict.json');

// OpenJTalk에 사전 적용
$openJtalk->useUserDict($userDict);

$audioQueryJson = $synthesizer->createAudioQuery($text, $styleId);

// JSON을 디코드하여 조정
$audioQuery = json_decode($audioQueryJson, true);
$audioQuery['speedScale'] = 1.2;   // 속도를 1.2배로
$audioQuery['pitchScale'] = 0.05;  // 피치를 조금 올림

$wav = $synthesizer->synthesis(json_encode($audioQuery), $styleId);
file_put_contents('./output.wav', $wav);

$accentPhrasesJson = $synthesizer->createAccentPhrases($text, $styleId);
$accentPhrases = json_decode($accentPhrasesJson, true);

// 모라의 피치와 음소 길이를 다른 스타일로 덮어쓰기
$updatedJson = $synthesizer->replaceMoraData($accentPhrasesJson, $styleId);

use Revolution\Voicevox\Core\Enums\AccelerationMode;

$synthesizer = new Synthesizer($onnxruntime, $openJtalk, AccelerationMode::Gpu);

// GPU 모드인지 여부를 확인
if ($synthesizer->isGpuMode()) {
    echo 'GPU 모드로 동작 중' . PHP_EOL;
}

$model0 = VoiceModelFile::open($voicevoxCoreDir . '/models/vvms/0.vvm');
$model1 = VoiceModelFile::open($voicevoxCoreDir . '/models/vvms/1.vvm');

$synthesizer->loadVoiceModel($model0);
$synthesizer->loadVoiceModel($model1);

// 모델에 포함된 스피커 정보를 확인
$metas = json_decode($synthesizer->metas(), true);

// 모델 언로드 (더 이상 필요하지 않을 경우)
$synthesizer->unloadVoiceModel($model0->id());

use Revolution\Voicevox\Core\Enums\OnExistingVoiceModelId;

$synthesizer->loadVoiceModel($model0, OnExistingVoiceModelId::Skip);

use Revolution\Voicevox\Core\VoicevoxCore;

$audioQuery   = $synthesizer->createAudioQuery($text, $styleId);
$audioFeature = $synthesizer->createAudioFeature($audioQuery, $styleId);

$frameRate        = (new VoicevoxCore)->getFrameRate();
$chunkFrameLength = max(1, (int) round(0.3 * $frameRate));
$totalFrames      = $audioFeature->length();

$stream = fopen('./talk.pcm', 'wb');

for ($start = 0; $start < $totalFrames; $start += $chunkFrameLength) {
    $end = min($start + $chunkFrameLength, $totalFrames);
    fwrite($stream, $audioFeature->slice($start, $end)->render());
}

fclose($stream);