VoicevoxResponse - VOICEVOX for Laravel

개요

VoicevoxResponse는 talk()->generate()나 song()->generate() 등 합성 실행 메서드가 반환하는 응답 오브젝트입니다. 클라이언트 모드에서도 네이티브 모드에서도 같은 VoicevoxResponse가 사용됩니다. 내부에서는 WAV 형식의 바이너리 데이터를 보유하며, 저장·변환·문자열화 유틸리티를 제공합니다.

`content()`

content()는 원시 WAV 바이너리를 반환합니다. HTTP 응답으로 그대로 반환하고 싶을 때 사용합니다.

use Revolution\Voicevox\Voicevox;

$response = Voicevox::talk('ずんだもんなのだ')->generate();
$wav = $response->content(); // WAV 바이너리

return response($wav)->header('Content-Type', 'audio/wav');

`storeAs()`

storeAs()는 Laravel의 Storage에 WAV를 저장합니다. 인수는 Storage::put()과 같은 사고방식으로 다룰 수 있습니다.

use Revolution\Voicevox\Voicevox;

$response = Voicevox::talk('ずんだもんなのだ')->generate();

// 파일 이름만 지정
$path = $response->storeAs('output.wav');

// 경로와 파일 이름을 나눠서 지정
$path = $response->storeAs('audio', 'output.wav');

// 디스크 지정
$path = $response->storeAs('audio', 'output.wav', 's3');

반환값은 저장한 경로 (string)입니다. 저장에 실패하면 false를 반환합니다.

`toBase64()`

toBase64()는 WAV 바이너리를 Base64 문자열로 변환합니다. JSON 응답이나 HTML 임베드에 사용할 수 있습니다.

$base64 = $response->toBase64();

return response()->json([
    'audio' => $base64,
]);

<audio controls src="data:audio/wav;base64,{{ $base64 }}"></audio>

`__toString()`

VoicevoxResponse를 문자열로 캐스팅하면 content()와 같은 WAV 바이너리가 반환됩니다.

$wav = (string) $response;

마지막 수정일 2026년 7월 13일

​개요

​content()

​storeAs()

​toBase64()

​__toString()

개요

`content()`

`storeAs()`

`toBase64()`

`__toString()`