Laravel AI SDK 연동

VOICEVOX for Laravel은 Laravel AI SDK와 통합되어 있어, Audio 파사드에서 음성 생성을 할 수 있습니다. 사용 가능한 드라이버는 다음 두 가지입니다.

voicevox-client (클라이언트 모드)
voicevox (네이티브 모드)

클라이언트 드라이버 (`voicevox-client`)

공식 VOICEVOX 엔진에 HTTP 요청을 보내는 모드입니다. FFI가 필요 없습니다.

사전 준비

docker pull voicevox/voicevox_engine:cpu-latest
docker run --rm -p '127.0.0.1:50021:50021' voicevox/voicevox_engine:cpu-latest

설정

config/ai.php에 voicevox-client 프로바이더를 추가합니다.

'providers' => [
    'voicevox-client' => [
        'driver' => 'voicevox-client',
        'key' => env('VOICEVOX_URL', 'http://127.0.0.1:50021'),
    ],
],

사용법

use Laravel\Ai\Audio;

$response = Audio::of('Laravel이 좋다이다')
    ->voice('ずんだもん')
    ->generate('voicevox-client');

Storage::put('talk.wav', $response->content());

네이티브 드라이버 (`voicevox`)

VOICEVOX CORE를 직접 호출하는 모드입니다. FFI가 필요합니다. config/voicevox.php의 core.vvms에 로드된 모델만 사용할 수 있습니다.

설정

'providers' => [
    'voicevox' => [
        'driver' => 'voicevox',
    ],
],

사용법

use Laravel\Ai\Audio;

$response = Audio::of('네이티브로 말하는 것이다')
    ->voice('ずんだもん')
    ->generate('voicevox');

Storage::put('talk.wav', $response->content());

`voice()`에 지정할 수 있는 값

voice()에는 다음을 지정할 수 있습니다.

VOICEVOX의 스타일 ID (숫자 문자열)
캐릭터명 별칭 (예: ずんだもん, 四国めたん/ノーマル)

별칭 목록

별칭	스타일 ID	캐릭터
`ずんだもん`	1	ずんだもん(あまあま)
`ずんだもん/あまあま`	1	ずんだもん(あまあま)
`ずんだもん/ノーマル`	3	ずんだもん(ノーマル)
`ずんだもん/セクシー`	5	ずんだもん(セクシー)
`ずんだもん/ツンツン`	7	ずんだもん(ツンツン)
`ずんだもん/ささやき`	22	ずんだもん(ささやき)
`ずんだもん/ヒソヒソ`	38	ずんだもん(ヒソヒソ)
`四国めたん/あまあま`	0	四国めたん(あまあま)
`四国めたん`	2	四国めたん(ノーマル)
`四国めたん/ノーマル`	2	四国めたん(ノーマル)
`四国めたん/セクシー`	4	四国めたん(セクシー)
`四国めたん/ツンツン`	6	四国めたん(ツンツン)
`四国めたん/ヒソヒソ`	37	四国めたん(ヒソヒソ)
`春日部つむぎ`	8	春日部つむぎ(ノーマル)
`波音リツ`	9	波音リツ(ノーマル)
`雨晴はう`	10	雨晴はう(ノーマル)
`玄野武宏`	11	玄野武宏(ノーマル)
`白上虎太郎`	12	白上虎太郎(ノーマル)
`青山龍星`	13	青山龍星(ノーマル)
`冥鳴ひまり`	14	冥鳴ひまり(ノーマル)
`九州そら`	16	九州そら(ノーマル)
`default-female`	10	雨晴はう(ノーマル)
`default-male`	12	白上虎太郎(ノーマル)

voice()를 생략한 경우에는 default-female (ID: 10)이 사용됩니다.

use Laravel\Ai\Audio;

Audio::of('테스트')->voice('3')->generate('voicevox-client');

사용 가능한 스피커 목록은 Voicevox::speakers()에서도 확인할 수 있습니다.

use Revolution\Voicevox\Voicevox;

$speakers = Voicevox::speakers();

에이전트 (KanalizerAgent)

네이티브 모드에서는 enable_katakana_english가 없기 때문에, 영어를 사전에 카타카나로 변환하는 KanalizerAgent를 사용할 수 있습니다.

use Revolution\Voicevox\Ai\Agents\KanalizerAgent;
use function Revolution\Voicevox\talk;

$kana = KanalizerAgent::make()->prompt('KanalizerAgent로 영어를 카타카나로 변환하는 것이다');

$response = talk($kana['kana'] ?? $kana->text, id: 1)->generate(id: 1);

$response->storeAs('native', 'kanalizer.wav');

AI에 의한 카타카나 변환은 항상 정확하다고는 할 수 없습니다. 실제 운영에서는 생성 텍스트를 사람이 확인한 뒤 합성하세요.

GitHub Copilot

SDK

AI SDK

VOICEVOX

스타터 킷

피드·RSS

미들웨어

Laravel AI SDK 연동 - VOICEVOX for Laravel