@stepfun/n8n-stepfun-integration

Stepfun.ai TTS for n8n

@stepfun/n8n-stepfun-integration 是一个 n8n 社区节点，用于在 n8n 中调用 Stepfun.ai 文本转语音（TTS）能力。

• NPM: https://www.npmjs.com/package/@stepfun/n8n-stepfun-integration
• GitHub: https://github.com/owenshen0907/n8n-node-stepfun

功能说明

• 将文本转换为语音音频
• 支持输出格式：mp3、aac、flac、wav、pcm、opus
• 输出 binary.audio，可直接接入后续节点

安装方式

n8n Public Cloud

• 在工作流编辑器点击 + 添加节点。
• 搜索 Stepfun 或 TTS。
• 选择并安装 Stepfun.ai TTS 节点。

Self-Hosted（推荐）

• 进入 Settings -> Community Nodes。
• 输入包名：@stepfun/n8n-stepfun-integration。
• 安装后重启 n8n。
• 在节点搜索中输入 Stepfun 或 TTS 使用节点。

手动 npm 安装（本地/服务器）

mkdir -p ~/.n8n/nodes
cd ~/.n8n/nodes
npm init -y
npm install @stepfun/n8n-stepfun-integration

安装后重启 n8n。

Docker / Compose 安装

确保 n8n 数据目录已挂载：

services:
  n8n:
    image: n8nio/n8n:latest
    volumes:
      - ~/.n8n:/home/node/.n8n

在宿主机执行：

mkdir -p ~/.n8n/nodes
cd ~/.n8n/nodes
npm init -y
npm install @stepfun/n8n-stepfun-integration

然后重启容器。

凭证配置

• 在 n8n 中进入 Credentials。
• 新建 Stepfun AI API Key。
• 填写以下参数：
  • API Key: 你的 Stepfun API Key（https://platform.stepfun.ai/interface-key）
  • Base URL: https://api.stepfun.ai/v1
• 保存凭证。

节点参数

• Text: 需要转换的文本内容
• Voice: 音色
• Model: 模型（默认 step-tts-2）
• Output Format: 音频格式

输出说明

节点会输出：

• json: 本次请求的参数信息
• binary.audio: 生成的音频文件

你可以将 binary.audio 连接到邮件、存储、HTTP 上传等后续节点。

常见问题

节点安装后看不到

• 确认已重启 n8n
• 确认安装包名为 @stepfun/n8n-stepfun-integration
• 在节点搜索中使用 Stepfun 或 TTS

凭证验证失败

• 检查 API Key 是否有效
• 检查 Base URL 是否为 https://api.stepfun.ai/v1
• 检查服务器是否可访问外网

许可证

MIT