> ## Documentation Index
> Fetch the complete documentation index at: https://kawax.biz/llms.txt
> Use this file to discover all available pages before exploring further.

# VoicevoxResponse - VOICEVOX for Laravel

> VOICEVOX for Laravel의 음성 합성 결과를 나타내는 VoicevoxResponse 클래스 메서드 해설.

## 개요

`VoicevoxResponse`는 `talk()->generate()`나 `song()->generate()` 등 합성 실행 메서드가 반환하는 응답 오브젝트입니다. 클라이언트 모드에서도 네이티브 모드에서도 같은 `VoicevoxResponse`가 사용됩니다.

내부에서는 WAV 형식의 바이너리 데이터를 보유하며, 저장·변환·문자열화 유틸리티를 제공합니다.

## `content()`

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

```php theme={null}
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()`과 같은 사고방식으로 다룰 수 있습니다.

```php theme={null}
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 임베드에 사용할 수 있습니다.

```php theme={null}
$base64 = $response->toBase64();

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

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

## `__toString()`

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

```php theme={null}
$wav = (string) $response;
```


## Related topics

- [VOICEVOX for Laravel](/ko/packages/laravel-voicevox/index.md)
- [엔진 API 모드: 토크 (텍스트 음성 합성) - VOICEVOX for Laravel](/ko/packages/laravel-voicevox/engine-talk.md)
- [설치와 설정 - VOICEVOX for Laravel](/ko/packages/laravel-voicevox/installation.md)
- [시작하기 - VOICEVOX for Laravel](/ko/packages/laravel-voicevox/getting-started.md)
- [.vvproj 파일 사양 - VOICEVOX for Laravel](/ko/packages/laravel-voicevox/vvproj.md)