n8n：本地文本转语音¶

集成 → n8n 导出一个使用 VoiceStudio 当前后端地址的手动工作流。它包含一个 Manual Trigger 节点和一个 HTTP Request 节点；它不会启用任何调度、安装 n8n、暴露你的后端，也不会包含凭据。

1. 启动 VoiceStudio 并安装/选择一个可用的 TTS 引擎。
2. 在 n8n 详情页选择 Save as…。通过 n8n 的工作流导入菜单导入 voicestudio-n8n.json。你也可以将其 JSON 复制到 n8n 中。
3. 打开 VoiceStudio HTTP Request 节点。编辑其 JSON 请求体中的 input。voice: "default" 使用引擎的默认设置；如需克隆，请使用已保存语音配置文件的 ID 或名称。model: "tts-1" 选择 VoiceStudio 当前激活的引擎。
4. 手动运行该工作流。请求会在二进制 audio 字段中返回 WAV 音频，可供后续 n8n 节点使用或下载。

可达性与身份验证¶

导出的地址适用于同一台计算机上的本机 n8n 进程。在 Docker 内部，127.0.0.1 指向容器，而不是你的桌面。请将节点 URL 替换为你的 n8n 进程实际能够访问的地址；Docker Desktop 通常提供 host.docker.internal（Podman 为 host.containers.internal）。VoiceStudio 开箱即用地接受发送到这些名称的请求，因此无需为它们添加 OMNIVOICE_ALLOWED_HOSTS 条目。Linux 容器网络可能需要显式的主机网关映射。云端 n8n 实例无法访问私有回环地址。请通过 API 身份验证指南 审慎配置远程访问，而不要在没有保护的情况下暴露桌面端口。

对于受保护的后端，请先为每个非回环连接使用 HTTPS（包括容器 host-gateway 地址）。不要将 Bearer 密钥附加到明文 HTTP 远程 URL；请先配置 TLS 或本地加密隧道。然后在 HTTP Request 节点中选择 Generic Credential Type → Header Auth，并将 Authorization: Bearer <your key> 存储在 n8n 的凭据管理器中。切勿将密钥放入 URL 或导出的工作流 JSON 中。重定向已被显式禁用，非成功响应仍将被视为错误。超时时间为 31 分钟，涵盖默认的 20 分钟模型加载和 10 分钟 CPU 生成预算，外加开销。更长的脚本或自定义后端预算可能需要在 n8n 中设置更大的超时时间。

复制/导入此工作流并不会建立实际连接。成功手动执行并生成 WAV，即可确认你的引擎、地址和凭据无误。VoiceStudio 在所选后端处理语音；后续 n8n 节点如何处理音频，则由你的工作流控制。

该节点配置遵循 n8n 官方的 HTTP Request 文档。测试使用本地测试引擎，通过 VoiceStudio 的真实 HTTP 路由发送导出的请求，并检查其 WAV 响应。生成的导出也已使用 n8n 2.39.8 在 Linux 上导入并执行，在其二进制输出中产生了有效的 WAV。每个生成的配置都有独立的工作流 ID，避免与无关工作流发生冲突。不会自动连接任何外部账户。