从录音
到语音。

用 pipertts 将 Piper 集成到 Node.js 项目

pipertts 在 Node.js 中暴露 Piper,支持文件写入或内存返回音频。推荐模式是 PiperNativeTTS:进程内 100% 原生推理 (ONNX + 编译的 espeak 桥),无需 Python,比包装器快约 10 倍。语音文件 (.onnx + .onnx.json) 保持独立。

1. 01

   安装依赖

   文档要求 Node.js 18+ 和 TypeScript 5+。原生模式无需其他依赖,执行 npm install 即可。传统包装器模式 (PiperTTS 通过 python3 -m piper) 还需要 Python 和 Piper 模块。通过目录 ID 选择可以将模型和配置下载到 models/。

   npm install pipertts
   # mode wrapper uniquement : python3 -m pip install piper-tts

2. 02

   从目录语音开始

   import { PiperNativeTTS, resolveModelPathFromOptions } from "pipertts";
   import * as fs from "node:fs";
   
   const modelPath = await resolveModelPathFromOptions({
     model: "en_US-lessac-medium",
     modelsDir: "./models",
   });
   const tts = await PiperNativeTTS.load({ modelPath });
   
   const { audio } = await tts.synthesize("Hello from Piper.");
   fs.writeFileSync("./hello.wav", audio);

3. 03

   使用本地模型

   对于手动下载的语音,传递 ONNX 文件路径。对应的 .onnx.json 文件应放在旁边;如果位置不同,可以指定 configPath。

   import { PiperNativeTTS } from "pipertts";
   
   const tts = await PiperNativeTTS.load({
     modelPath: "./models/my-voice.onnx",
   });
   const { audio, sampleRate } = await tts.synthesize("Hello.", { speakerId: 0 });

4. 04

   API 和格式

   synthesize() 返回 audio (Buffer)、sampleRate 和 text;outputFile 还写入磁盘。选项:speakerId (多语音和多风格)、lengthScale (> 1 减慢,< 1 加快)、noiseScale、noiseWScale、sentenceSilence、normalizeAudio、volume 和 outputFormat (wav、raw、mp3、ogg 或 opus)。mp3 和 opus 有纯 JS 实现;ogg 需要 FFmpeg。phonemize() 和 synthesizeChunks() 提供逐句的底层访问。

5. 05

   传统包装器 (PiperTTS)

   PiperTTS 启动 python3 -m piper,每次合成一个进程;慢约 10 倍,仅适用于原生引擎无法运行的环境。需要 Python 和 Piper 模块。

   import { PiperTTS } from "pipertts";
   
   const tts = await PiperTTS.create({
     modelPath: "./models/en_US-lessac-medium.onnx",
   });
   await tts.synthesizeToFile("Hello from the legacy wrapper.", "./hello.wav");

   pipertts 的 npm 页面 ↗pipertts 的 GitHub 仓库 ↗pipertts 文档和示例 ↗