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() 会将 WAV 保存到 Laravel 的 Storage。参数用法与 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()`