Từ bản ghi âm
thành giọng đọc.

Tích hợp Piper trong dự án Node.js bằng pipertts

pipertts đưa Piper vào Node.js, với đầu ra tệp hoặc âm thanh trong bộ nhớ. Chế độ khuyến nghị là PiperNativeTTS: suy luận 100% gốc trong tiến trình (ONNX + cầu espeak đã biên dịch), không cần Python, nhanh gấp khoảng 10 lần wrapper. Giọng đọc (.onnx + .onnx.json) vẫn là các tệp riêng.

1. 01

   Cài đặt các phụ thuộc

   Tài liệu ghi Node.js 18+ và TypeScript 5+. Chế độ gốc không cần gì thêm: chỉ npm install là đủ. Chế độ wrapper cổ điển (PiperTTS qua python3 -m piper) còn cần Python và mô đun Piper. Chọn theo ID danh mục có thể tải mô hình và cấu hình của nó vào models/.

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

2. 02

   Bắt đầu nhanh với giọng đọc danh mục

   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

   Dùng mô hình cục bộ

   Với giọng đọc tải xuống thủ công, hãy truyền đường dẫn tệp ONNX. Tệp .onnx.json đi kèm phải đặt cạnh bên; bạn có thể chỉ rõ configPath nếu vị trí của nó khác.

   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 và định dạng

   synthesize() trả về audio (Buffer), sampleRate và text; outputFile cũng ghi ra đĩa. Tùy chọn: speakerId (đa giọng đọc và đa phong cách), lengthScale (> 1 làm chậm, < 1 làm nhanh), noiseScale, noiseWScale, sentenceSilence, normalizeAudio, volume và outputFormat (wav, raw, mp3, ogg hoặc opus). mp3 và opus có giải pháp JS thuần; ogg cần FFmpeg. phonemize() và synthesizeChunks() cho quyền truy cập cấp thấp, từng câu một.

5. 05

   Wrapper cũ (PiperTTS)

   PiperTTS khởi chạy python3 -m piper, 1 tiến trình cho mỗi lần tổng hợp: chậm hơn khoảng 10 lần, chỉ dành cho môi trường mà engine gốc không chạy được. Cần Python và mô đun 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");

   Trang npm của pipertts ↗Kho GitHub của pipertts ↗Tài liệu và ví dụ pipertts ↗