前言
想让你的日报、短视频文案自动生成真人般流畅的配音吗？
无需懂代码，本教程将带你一步步在 N8N 中配置火山引擎 TTS API。
跟着操作，你就能轻松搭建一个内容自动配音的工作流。
彻底告别繁琐的人工配音，极大提升内容生产效率。
配置目的
我们的目标非常明确：将一段文本（例如每日资讯、报告摘要）输入 N8N 工作流，自动调用火山引擎的语音合成服务，最终生成一个高质量的 MP3 配音文件。
这个过程将完全自动化，无需人工干预。
前期准备
在开始配置 N8N 之前，请确保你已完成以下准备工作：
1. 注册火山引擎账号：
访问火山引擎官网并完成注册。
2. 开通语音合成服务：
进入控制台，找到“语音技术”或“豆包语音”相关产品，并开通“语音合成 TTS”服务。
3. 获取关键凭证：
在火山引擎的控制台中，找到“访问控制”或“密钥管理”部分。你需要获取两个关键信息：AppID 和 Access Token（它将用作我们的 API 密钥）。请将它们复制并妥善保存。
N8N 节点配置步骤
整个配置的核心是 N8N 的 HTTP Request 节点。假设你的工作流上一个节点已经准备好了需要配音的文本。
添加并设置节点
1. 在 N8N 画布中，点击加号，搜索并添加 HTTP Request 节点。
2. 请求方法 (Method)：在下拉菜单中，选择 POST。
3. 请求地址 (URL)：粘贴火山引擎的官方 API 地址：
https://openspeech.bytedance.com/api/v1/tts
4. 身份认证 (Authentication)：选择 Header Auth。
配置认证信息
点击 Headers 下的 Add Header 按钮，我们需要添加一个认证头。
- Name: 填写
Authorization - Value: 填写
Bearer;你的Access_Token
请特别注意：
Bearer 和你的 Access Token 之间是一个英文分号 (;)，不是空格！请将 “你的Access_Token” 替换成你从火山引擎获取的真实密钥。
构造请求体
1. 将 Body Content Type 选项设置为 JSON。
2. 在下方的 Body 输入框中，粘贴以下基础 JSON 结构：
{ "app": { "appid": "你的AppID", "token": "随意填写但不能为空", "cluster": "volcano_tts" }, "user": { "uid": "随意填写但不能为空" }, "audio": { "voice_type": "BV700_streaming", "encoding": "mp3", "speed_ratio": 1.0 }, "request": { "reqid": "{{$runIndex}}", "text": "{{$json.text}}", "operation": "query" } }
你需要将 你的AppID 替换为真实的 AppID。text 字段的值 {{$json.text}} 是一个表达式，它会动态获取上一个节点输出的名为 `text` 的字段内容。
关键参数说明
Authorization (Bearer Token): 这是 API 的通行证，证明你有权限访问服务。格式必须是 Bearer;密钥，分号至关重要。
AppID: 这是你的应用标识，用于火山引擎识别是哪个应用在发起请求。它需要填写在请求体 (Body) 的 `app.appid` 字段中。
voice_type: 这个参数决定了配音的音色。你可以参考火山引擎的官方文档，选择你喜欢的音色代码进行替换。
text: 这里填写需要转换成语音的文本内容。在实际工作流中，我们通常使用 N8N 表达式动态传入。
常见错误提示
如果在测试节点时遇到错误，可以参考以下常见问题进行排查：
- 认证失败 (authenticate request…): 大概率是 `Authorization` 头部配置错误。请检查 Access Token 是否正确，以及 `Bearer` 和 Token 之间是否用了英文分号。
- 音色不存在 (voice_type … not found): 检查 `voice_type` 字段的值是否为火山引擎支持的官方音色代码。
- AppID 错误或权限不足: 确认请求体中的 `appid` 是否填写正确，以及该 AppID 关联的服务是否已正常开通且未欠费。
- 无效文本 (illegal input text): 检查传入的 `text` 字段是否为空或者包含不支持的特殊字符。
完成以上配置并成功执行后，HTTP Request 节点会返回包含音频数据的 JSON。你可以在后续节点中，使用“Move Binary Data”和“Write Binary File”节点，将其解码并保存为 MP3 文件，实现完整的自动化配音流程。
