跳转到主要内容

Laravel AI SDK 集成

VOICEVOX for Laravel 与 Laravel AI SDK 已完成集成,可通过 Audio Facade 生成语音。 可用的驱动有以下两种:
  • voicevox-client(客户端模式)
  • voicevox(原生模式)

客户端驱动(voicevox-client

向官方 VOICEVOX 引擎发送 HTTP 请求的模式。无需 FFI。

前置准备

配置

config/ai.php 中添加 voicevox-client provider。

使用方法

原生驱动(voicevox

直接调用 VOICEVOX CORE 的模式。需要 FFI。 仅能使用 config/voicevox.phpcore.vvms 已加载的模型。

配置

使用方法

可传给 voice() 的值

voice() 可以指定以下内容:
  • VOICEVOX 的 Style ID(数字字符串)
  • 角色名别名(例如 ずんだもん四国めたん/ノーマル

别名列表

如果省略 voice(),将使用 default-female(ID:10)。
可用的说话人列表也可以通过 Voicevox::speakers() 查看。

Agent(KanalizerAgent)

由于原生模式没有 enable_katakana_english,你可以使用将英语提前转换为片假名的 KanalizerAgent
基于 AI 的片假名转换并非总是准确。在实际使用中,请让人工确认生成的文本后再进行合成。

下一步阅读

客户端:Talk

了解客户端模式下常规 API 的调用流程。

原生:Talk

了解通过 FFI 直接合成的模式的用法。
最后修改于 2026年7月18日