## 基础配置

TTS 服务连接与朗读设置

试用音色 — 无需配置，使用插件服务器（11个音色）
鉴权音色 — 需配置火山引擎 API（200+ 音色 + 复刻）
鉴权配置（可选）
未配置
配置后可使用预设音色库和复刻音色
AppID
Access Token

获取方式见「使用说明」页

朗读设置
AI 回复后自动朗读
语速
1.0x
文本过滤
跳过区间

遇到「起始」后跳过，直到「结束」。起始或结束可单独留空。

当前规则
启用只读区间（仅朗读匹配内容）

起始或结束可单独留空。

只读规则

## 音色管理

将喜欢的音色重命名加入【我的音色】

当前默认音色
未选择
请在下方选择音色

点击选中设为默认。试用 无需配置，鉴权 需配置 API

暂无音色，请从「试用」或「预设库」添加
手动添加复刻音色 鉴权
音色 ID
名称
复刻版本
使用预设音色库需要先配置鉴权 API，请前往「基础配置」页面设置。

## 高级设置

计费、缓存与过滤选项（鉴权模式）

计费与缓存
返回计费用量（text_words）
启用火山服务端缓存
过滤与识别
启用 Markdown 过滤
启用 1.1 模型（仅对 seed-tts-1.0 生效）
不过滤 Emoji
启用自动语种识别
指定语种
括号过滤长度
音高调整

## 缓存管理

本地音频缓存统计与清理

0
缓存条数
0 MB
占用空间
0
命中
0
未命中
缓存配置
缓存天数
最大条数
最大容量 (MB)

## 使用说明

配音指令与开通流程

### 配音指令

格式：`[tts:speaker=音色名;emotion=情绪;context=语气提示]` 放在正文前一行

speaker、emotion、context 三个参数可任意组合、任意顺序，用分号分隔

每遇到一个新 `[tts:...]` 块会分段朗读，按顺序播放

未写 `speaker=` 的块使用当前选中的默认音色

音色（speaker）

只能指定"我的音色"中保存的名称。例如保存了名为"小白"的音色，则可用 `speaker=小白`。

情感（emotion）可用值：

    中文：开心、悲伤、生气、惊讶、恐惧、厌恶、激动、冷漠、中性、沮丧、撒娇、害羞、安慰、鼓励、咆哮、焦急、温柔、讲故事、自然讲述、情感电台、磁性、广告营销、气泡音、低语、新闻播报、娱乐八卦、方言、对话、闲聊、温暖、深情、权威

    英文：happy, sad, angry, surprised, fear, hate, excited, coldness, neutral, depressed, lovey-dovey, shy, comfort, tension, tender, storytelling, radio, magnetic, advertising, vocal-fry, asmr, news, entertainment, dialect, chat, warm, affectionate, authoritative

语气提示（context）仅对 seed-tts-2.0 生效：

例如："用更委屈的语气"、"放慢一点，压低音量"

### 复刻音色使用

1. 在火山官网复刻音色
2. 获取音色ID（格式 `S_xxxxxxxx`）
3. 在"音色管理" → "我的音色"中添加

以下是鉴权模式的开通教程，试用音色无需配置。

### 开启 CORS 代理

1. 打开酒馆目录的 config.yaml
2. 将 enableCorsProxy 改为 true 并保存
3. 重启酒馆（重启容器/进程，不是 F5 刷新）

### 开通服务（推荐一次性开通全部）

https://console.volcengine.com/speech/new/setting/activate

### 获取 Access Token / AppID

https://console.volcengine.com/speech/service/8

### 声音复刻入口(复刻后去音色库拿ID)

https://console.volcengine.com/speech/new/experience/clone