用 ElevenLabs 把文字变成语音的 webhook

用 ElevenLabs 把文字变成语音的 webhook

一个 n8n 工作流，给你一个用于文字转语音的小小 Web 地址。你给它一个声音 id 和一段文字。它请 ElevenLabs 把文字朗读出来，再在回复里把音频文件发回来。任何能发 Web 请求的工具都能用它。

包里有什么

• workflow.json：n8n 导出的工作流，6 个节点，其中一个是便签。里面没有任何凭据，也没有密钥。
• README.md：这份设置说明，压缩包里的是英文版。

我们相对原来的副本改了什么

• Generate voice 上的凭据关联已删掉。请按“设置”里的说明创建你自己的。
• If params correct 原来比较的是普通文字 voice_id 和 text，它们永远存在，所以这个检查从不失败。现在它的两个条件分别读 {{ $json.body.voice_id }} 和 {{ $json.body.text }}。
• Generate voice 的 JSON 请求体原来手动用引号把文字括起来，所以文字里的引号或换行会让请求出错。现在它用 JSON.stringify 写入文字。
• 文件原来没有设置块。现在它设了常用的执行顺序 v1。
• 那张便签原来是作者的一段个人留言。现在它是一张带设置说明的简短便签。

开始之前

• 一个 n8n 实例。
• 一个 ElevenLabs 账号和它的 API 密钥。ElevenLabs 按你转换的字符数收费，受你套餐的限额约束。
• 你的 ElevenLabs 账号里一个声音的 id。你可以在那里这个声音的设置里找到它。

设置

1. 在 n8n 里新建一个工作流，打开它的菜单，选 Import from File，选中 workflow.json。
2. 创建一个 Custom Auth 凭据，内容如下，并在 Generate voice 里选中它：{"headers": {"xi-api-key": "<YOUR_ELEVENLABS_API_KEY>"}}
3. 激活工作流，再从 Webhook 复制生产地址。它的路径是 generate-voice。
4. 发一个带 JSON 内容的 POST 请求，把回复存成 MP3 文件：

curl -X POST "<YOUR_WEBHOOK_URL>" -H "Content-Type: application/json" -d '{"voice_id": "<YOUR_VOICE_ID>", "text": "Hello from n8n."}' --output speech.mp3

一次运行的过程

1. Webhook 等着 generate-voice 上的 POST 请求。它稍后才回复，由一个 Respond to Webhook 节点来回复。
2. If params correct 检查请求体里有没有 voice_id 和 text。
3. 两个都有时，Generate voice 把文字发给 ElevenLabs 的 /v1/text-to-speech/<voice_id>，你的密钥放在 xi-api-key 请求头里。ElevenLabs 返回音频，n8n 把它当作二进制文件保存。
4. Respond to Webhook 把这个文件返回给调用方。
5. 缺了一个时，Error 回复 {"error": "Invalid inputs."}。

改变风格

• 声音：每次请求发一个不同的 voice_id。工作流里没有固定的声音。
• 模型和格式：请求体只发 text，所以 ElevenLabs 用它的默认值，模型 eleven_multilingual_v2 和格式 mp3_44100_128（它的参考文档，2026 年 11 月 12 日查阅）。想改的话，就在 Generate voice 的请求体里加上 model_id 或 output_format。有些格式需要更高的套餐。
• 路径：改 Webhook 里的 generate-voice。

注意事项

• 这个地址是开放的。任何有这个 URL 的人都能生成音频，而 ElevenLabs 向你的账号收费。请在 Webhook 里打开一种 Authentication 选项，比如 Header Auth，再从你的调用方发送密钥。
• 这个检查只测两个字段都在。只有空格的文字，或空字符串，都能通过，ElevenLabs 随后会返回错误。
• 无效输入的回复是 HTTP 200，带一个 JSON 内容。如果你的调用方会读状态码，就在 Error 里把响应码设成 400。
• 当 ElevenLabs 拒绝这次调用时，比如声音 id 不对，或者账号的字符数用完了，运行会失败，调用方收到来自 n8n 的错误。
• 你的数据：文字会发给 ElevenLabs，你的工具收到音频。
• 请使用你有权使用的声音，并查看 ElevenLabs 的条款，了解你可以怎样使用这些音频。