n8n-nodes-doubao

n8n-nodes-doubao

🎤 豆包（火山引擎）n8n社区节点包 - 让你的工作流拥有语音能力

✨ 特性

🎯 豆包TTS（文本转语音）

• 🗣️ 高质量语音合成
• 🎭 多种音色模型（男声、女声、情感语音）
• 🎵 多种音频格式（MP3、WAV、PCM）
• ⚡ 可调节语速、音量、音调
• 🌐 支持多语言（中文、英文、日文、韩文）
• 💫 情感风格控制（开心、悲伤、愤怒等）

🚀 快速开始

📦 安装

# 在你的n8n项目目录中安装
npm install n8n-nodes-doubao

# 或者全局安装（如果你全局安装了n8n）
npm install -g n8n-nodes-doubao

🔧 前提条件

• Node.js >= 18.19.0
• npm >= 9.x
• n8n >= 1.0.0

⚡ 一分钟上手

• 重启n8n服务
• 在节点面板中找到 "Doubao TTS" 节点
• 配置API凭据（见下方配置说明）
• 开始使用！

🔑 获取API密钥

• 访问 火山引擎控制台
• 注册账号并完成实名认证
• 开通语音合成服务
• 获取以下信息：
  • Access Token: saz63EHNhv3hfrJ83JGa_EZTzH2bfZpw
  • Secret Key: ZeJclvAHbepvxNW13uRcp52W6UvJ8Eyq

⚙️ 在n8n中配置

• 在n8n界面中，点击 "Credentials" → "+ New Credential"
• 搜索并选择 "Doubao API"
• 填入你的API信息并保存
• 在节点中选择该凭据

💡 使用示例

🎵 基础用法

# 简单的文本转语音
输入文本: "欢迎使用豆包语音合成服务！"
音色: BV700_streaming (标准女声)
输出: MP3音频文件

🎭 进阶配置

# 带情感的语音合成
输入文本: "恭喜您获得了大奖！"
音色: BV700_streaming
情感: happy (开心)
语速: 1.2 (稍快)
音量: 1.5 (稍大)

🌟 实际应用场景

场景	配置建议	说明
📰 新闻播报	男声 + 正常语速 + 正常情感	适合新闻、通知播报
🎧 有声书	女声 + 较慢语速 + 温和情感	适合长时间收听
🚨 紧急通知	响亮音量 + 较快语速 + 紧急情感	适合警报、提醒
👶 儿童内容	甜美女声 + 较慢语速 + 开心情感	适合儿童故事

📚 参数说明

🎤 音色选项

音色代码	描述	特点
BV700_streaming	标准女声	清晰自然，适合通用场景
BV701_streaming	标准男声	沉稳有力，适合正式场合
BV001_streaming	甜美女声	温柔可爱，适合亲和场景
BV002_streaming	磁性男声	低沉醇厚，适合广播场景

🎭 情感风格

情感值	说明	适用场景
normal	正常	一般播报、通知
happy	开心	祝贺、庆祝内容
sad	悲伤	哀悼、慰问内容
angry	愤怒	警告、严厉内容
surprised	惊讶	意外、突发消息

🔧 技术参数

参数	范围	默认值	说明
语速比例	0.5 - 2.0	1.0	语音播放速度
音量比例	0.1 - 3.0	1.0	音频音量大小
音调比例	0.5 - 2.0	1.0	声音音调高低
采样率	8000/16000/24000	24000	音频质量

🔧 故障排除

常见问题

问题	解决方案
🚫 节点未出现	确认安装成功并重启n8n
🔑 认证失败	检查Access Token和Secret Key
🌐 网络错误	确认网络连接和防火墙设置
📢 音质问题	调整采样率和压缩设置
⏱️ 处理缓慢	缩短文本长度或调整参数

获取帮助

• 🐛 提交Bug报告
• 💬 功能请求
• 📖 查看文档

📖 文档

• 📘 开发文档 - 详细的开发指南
• 🚀 快速启动 - 5分钟快速上手
• 🎯 n8n使用指南 - 完整的n8n使用说明
• 🔗 API文档 - 豆包API官方文档

🤝 贡献

欢迎贡献代码！请查看 DEVELOPMENT.md 了解详细的贡献指南。

开发者快速启动

# 克隆项目
git clone https://github.com/shrekai2025/n8n-nodes-doubao.git
cd n8n-nodes-doubao

# 安装依赖
npm install

# 开发模式
npm run dev

  # 构建
  npm run build

🌟 路线图

• ✅ 豆包TTS基础功能
• ✅ 多音色支持
• ✅ 情感风格控制
• ✅ 多语言支持
• 🔄 豆包ASR（语音识别）
• 🔄 豆包NLP（自然语言处理）
• 🔄 批量处理优化
• 🔄 缓存机制

💝 致谢

• 🙏 感谢 n8n 团队提供的出色平台
• 🙏 感谢 火山引擎 提供的豆包API服务
• 🙏 感谢所有贡献者和社区成员的支持

📄 许可证

MIT License - 查看 LICENSE 文件了解详情

🔗 相关链接

• 🏠 项目首页
• 📦 NPM包
• 🐛 Issue跟踪
• 💬 讨论区

⭐ 如果这个项目对你有帮助，请给个Star支持一下！

💡 这是一个社区开发的非官方节点包，不隶属于n8n或火山引擎官方