博客指南

让大肥鱼在 QQ 群里开口:BreezeBlue 语音接入指南

保留 Bot 的人设和记忆,挑一个像它的声音,把接入交给部署助手,再一起听听它在 QQ 群里说的第一句话。

一条橙色小鱼在宁静的蓝色池塘里吐出对话气泡,声波化成水面涟漪。

大肥鱼是大家带进 QQ 群里的角色 Bot。如果你家的鱼已经会接话了,你一定熟悉它的样子:有时机灵,有时迷糊,还有时明明在摸鱼,嘴上却说自己在认真思考。

如果这些话能用它自己的声音说出来呢?保留现在的聊天模型、人设和记忆,让 BreezeBlue 把最终回复生成音频,再由原来的 QQ 接入工具发成语音消息。

先选一个像它的声音

先打开下面两款音色的页面试听。两款都是普通话角色音色;切换文章语言,不会改变声音示例的语言。

音色试听给部署助手的 Voice ID
大肥鱼 · 机灵版听听机灵版voc_u3nxkd5578wc
大肥鱼 · 迷糊版听听迷糊版voc_8yud7hz7c9q2

想一想它平时怎样接话:被夸时会不会得意,走神后怎样回神,被拆穿时又是什么语气。先找到喜欢的声音,再用日常短句试试。

也可以用音色设计描述自己想要的声音,不需要先准备录音。想让鱼说普通话,可以试试这样的描述:

标准普通话,声音清亮、轻软,平时有一点小迷糊;想到好主意时会突然雀跃起来。

试听少量候选,保存喜欢的版本,接入时使用保存后的 Voice ID。生成试听也会消耗 credits,保存数量取决于套餐,详细步骤见音色设计流程。

找到能操作 Bot 的人或助手

群里的大肥鱼负责聊天。给它增加语音,需要访问运行它的电脑、容器或管理面板。只有群聊权限的 Bot,无法替你配置部署环境。

  • 自己部署,有助手能操作项目:把下面的任务交给 AI 编程助手,让它先检查已有的 QQ 连接和语音能力。

  • 只有管理网页:告诉助手平台名称,确认能否配置外部语音服务或安装语音插件。

  • 朋友部署或购买托管服务:把文章转给部署者,确认能否接入 BreezeBlue,以及能否发送 QQ 语音消息。

手机可以用来选声音、转发任务和试听。安装与配置应在 Bot 所在的环境完成。如果不清楚怎么部署的,先找到当初帮你把鱼接进群的人。

已经在用本机 Breeze、豆包或其他语音服务?记得告诉助手。它需要同时检查语音提供方和插件,避免一条回复触发两套声音,并保留现有的人设和记忆设置。

把接入任务交代清楚

先选一个声音,把下面的任务复制给能访问 Bot 项目的 AI 助手,并附上选中的 Voice ID。文章附带的 Skill 提供了更详细的检查与验收步骤。

给我现有的大肥鱼 QQ Bot 增加按需发送 BreezeBlue 语音消息的功能。
保留现有聊天模型、人设、记忆和 QQ 连接。
使用我选定的正式 Voice ID;如果还没选,请先让我试听。

修改前先检查框架、QQ 适配器及版本、运行环境和已有语音插件。
读取本文附带的 Skill 与当前官方文档:https://docs.breezeblue.ai/
如果无法访问部署环境,说明需要部署者提供什么。
不能假定本地 TTS 服务只换地址和 Key 就能调用云端 API。
通过安全入口登录或配置凭据,不在聊天、日志或群消息中显示密钥。

先说明测试用量,再生成这一句普通话:
呜哇,被你发现啦!我在认真思考呢,才没有摸鱼。
让我指定测试群并确认发送这一条消息。
分别检查音频生成、QQ 送达,以及手机和电脑的完整播放。

初期仅在明确要求语音时触发,设置文本长度和每日用量上限。
长回复保留文字,失败时回退文字,避免重复消息。
备份相关配置,交付启用、停用和回退方法。
列出所有仍未验证的环节。

这段说明用于交代任务,实际接入取决于已安装的框架和音频发送接口。首次测试保持少量;若缺少能力,先让助手说清楚再继续。

让鱼说一句,要花多少钱?

按 2026 年 10 月 29 日的标准 TTS 口径,1 credit 对应 10 个计费字符,中文汉字每字计 2 个;充值单价为 $3 / 10,000 credits。下面按纯汉字估算:

使用量Credits按充值单价折算(美元)
一条 50 字的回复10$0.003
100 条回复,每条 50 字1,000$0.30
每天 100 条,连续 30 天,每条 50 字30,000$9.00

标点和其他字符也会计入用量,重新生成会再次消耗 credits。表内是语音生成费用估算,未扣除免费额度,不包含聊天模型、服务器、托管和音色设计费用。

Free 套餐月费为 $0,每天可手动领取 400 credits,按每条 50 个纯汉字的同一假设约够 40 条回复。网页和 API 共用账户余额。充值、订阅及具体规则见当前价格页。

第一条语音,要过三个检查点

在指定测试群里试一句短回复。保留这句普通话测试台词,方便对照选中的声音和原文:

普通话测试台词

呜哇,被你发现啦!我在认真思考呢,才没有摸鱼。

01

生成

部署环境拿到了完整、可以播放的音频文件。

02

送达

指定 QQ 群里出现一条可点击的语音消息。

03

试听

手机和电脑都能播放完整回复,再由你判断听感。

如果生成成功、发送失败,就检查 QQ 适配器、音频格式和文件传递。Bot 与 QQ 桥可能运行在不同机器上,本地路径不会自动在两者之间共享。

开始时按口令开口就好,长篇解释继续用文字,失败时也保留文字回复。毕竟群友想听鱼说话,也不一定想听它念三千字检讨。

给部署助手的接入资料

所有文章语言共用同一份接入资料。Skill 采用英文,上面的可复制任务使用当前文章语言。包内链接采用相对路径,解压后也能沿目录读取。

  • Agent 入口:从这里读取 Skill 和参考资料。

  • 阅读 Skill:环境检查、凭据配置、用量限制和验收要求。

  • 下载完整 ZIP:包含入口、Skill、参考资料、音色目录和验证状态。

  • 验证状态:资料包的用途与仍待完成的真实接入检查。

资料包提供操作说明,不包含现成的 QQ 插件。读取材料本身不代表获得安装、消费额度或发送消息的授权;具体操作以你实际交给助手的任务为准。

鱼友常问的几件事

已经在本机运行 Breeze,为什么还要用云端?

取决于你希望怎样维护。本地部署由自己提供运行语音模型的机器;使用 API 时,由 BreezeBlue 运行模型,按生成用量计费。Bot 本身仍需保持在线,并完成音频收发。

填了 API Key,为什么还是没有声音?

分别检查文字回复、BreezeBlue 合成和 QQ 发送。先确认凭据属于对应服务、账户额度可用,再根据隐藏密钥后的报错定位。聊天模型和语音服务使用各自的配置。

换声音会改变它的人设或记忆吗?

语音负责读出准备好的回复。人设、记忆以及群聊与私聊的上下文,仍由原来的 Bot 管理。接入时应保留这些设置;聊天表现的差异需要单独检查。

想说日语,为什么夹着中文?

先检查文字。文字已经混用语言时,先处理聊天回复;文字正确而读音不对时,再检查语音模型和语言设置,用短句复测。支持的组合见语音合成文档。

哪一种声音,像你家的鱼?

先听听两款声音,选一个喜欢的,再把第一项接入任务交给部署助手。