企业官网建设流程全解析

• 人工智能
• AI 应用
• 语音
• 音频
• 媒体生成

TTS-Audio-Suite 是 ComfyUI 的本地多引擎、多语言语音合成（TTS）节点插件，支持 F5-TTS、ChatterBox 23-Lang、Higgs Audio v3、VibeVoice 等 19 个引擎。它的核心亮点之一是多语言切换：只需在文本中嵌入[de:Alice]这样的方括号标签，就能在一段文字里无缝切换 23+ 种语言和多个角色声音，无需为每种语言单独搭建工作流。本指南将带你 5 分钟掌握这套 TTS 多语言切换方法。

🧩 TTS-Audio-Suite 是什么

简单来说，它是一个"统一入口"的本地语音工具箱：一条工作流里可以混合使用不同引擎、不同角色、不同语言，还自带 SRT 字幕时序、角色别名、音频分析等工具。

多语言切换功能主要作用于两个统一入口节点：

• TTS Text：纯文本输入，直接生成多语言语音，节点实现见 tts_text_node.py
• TTS SRT：按字幕时序逐条生成，适合视频配音，节点实现见 tts_srt_node.py

⚡ 核心语法：4 种方括号标签

多语言切换的全部秘密就在方括号里，一共 4 种写法：

实际文本示例：

Hello! This is English text with the default model. [de:Alice] Hallo! Ich spreche Deutsch mit Alice's Stimme. [fr:] Bonjour! Je parle français avec la voix du narrateur. [es:Bob] ¡Hola! Soy Bob hablando en español. Back to English with the original model.

标签后面的段落会用指定语言/角色朗读，遇到新标签或回到无标签文字时自动切回默认。这套语法由 language_resolver.py 解析，解析过程完全容错：标签里的标点会自动清理，找不到对应语言模型时会警告并回退到默认模型，不会中断工作流。

🌍 语言代码与别名：不用死记硬背

语言代码遵循通用 ISO 短码，但系统内置了一整套别名表（定义在 language_mapper.py），你甚至可以写：

• [german:Alice]、[Deutsch:Bob]→ 德语
• [中文:旁白]、[chinese:]→ 中文（zh-cn简体 /zh-tw繁体）
• [Brazil:]→ 巴西葡语（pt-br），而[Portugal:]→ 欧洲葡语（pt-pt）
• [日本語:Tom]、[한국어:Tom]→ 日语、韩语

常用代码速查（节选自 LANGUAGE_SUPPORT.md）：

📊 各引擎支持哪些语言

不同引擎的语言能力差异很大，切换前值得先确认：

• ChatterBox 23-Lang：官方 24 语言模型，是"23+ 种语言"的主力，标签直接控制输出语言
• F5-TTS：按语言切换独立模型（F5-DE、F5-FR、F5-PT-BR 等），支持英/德/西/法/意/日/泰/葡/印地等
• Higgs Audio v3：官方宣称 100+ 语言，从文本自动检测
• CosyVoice3：中文 + 18 种方言（粤语、四川话、东北话等）

完整矩阵（含 90+ 语言行）请查看 docs/LANGUAGE_SUPPORT.md。

⚠️ 注意：VibeVoice / KugelAudio、Higgs Audio v3、Fish Audio S2这几个引擎从文本自动检测语言，语言标签对它们不起作用；而对 F5-TTS、ChatterBox、Qwen3-TTS 等引擎，标签会直接切换语言模型。

🎯 语言解析优先级：谁说了算

同一个角色[Alice]到底说哪种语言？系统按以下优先级从高到低解析（逻辑见 language_resolver.py）：

1. 显式语言标签：[de:Alice]最高优先
2. 角色默认语言：在别名文件#character_alias_map.txt中为该角色设置，例如Alice = female_01, de
3. 节点全局默认语言：工作流里选择的默认值

示例（若 Alice 的别名默认语言是de）：

[Alice] → 说德语（来自别名默认） [en:Alice] → 说英语（显式覆盖）

完整的角色 + 语言组合玩法（含别名映射表格式）详见 docs/CHARACTER_SWITCHING_GUIDE.md。

📺 SRT 字幕场景：逐句切换语言

对字幕时序工作流，方括号标签可以直接写在 SRT 文本行里，每条字幕各自指定语言，音频会精确对齐时间轴：

1 00:00:01,000 --> 00:00:04,000 Hello! Welcome to our multilingual show. 2 00:00:04,500 --> 00:00:08,000 [de:female_01] Willkommen zu unserer mehrsprachigen Show! 3 00:00:08,500 --> 00:00:12,000 [fr:] Bienvenue à notre émission multilingue!

可参考示例工作流 Unified 📺 TTS SRT.json 了解完整连线方式。

💡 实用技巧与常见问题

• 回退机制很可靠：[UnknownCharacter]会警告并使用旁白声音；[xx:]指定的语言若模型缺失，会自动回退默认模型，工作流不会报错中断
• 调试看日志：切换时控制台会输出🌍 F5-TTS: Language switching mode、Loading F5-TTS model 'F5-DE' for language 'de'等信息，方便确认模型是否切换成功
• F5-TTS 特殊注意：参考音频建议小于 12 秒，且每个角色需同时提供音频 +.reference.txt文本文件；ChatterBox 只需要音频
• 长文本放心用：超长段落会按语言分组智能切块，同语言段落集中处理，减少模型切换开销

📚 相关资源

• 语言支持矩阵：docs/LANGUAGE_SUPPORT.md
• 角色与语言切换完整指南：docs/CHARACTER_SWITCHING_GUIDE.md
• 语言别名映射源码：utils/models/language_mapper.py
• 标签解析器源码：utils/text/character_parser/language_resolver.py

掌握这套方括号语法后，一部多语言有声书、跨国合声的视频配音，只需一条工作流就能搞定。

• 人工智能
• AI 应用
• 语音
• 音频
• 媒体生成