Dari rekaman
menjadi suara.

Mengintegrasikan Piper dalam proyek Node.js dengan pipertts

pipertts menghadirkan Piper di Node.js, dengan output file atau audio dalam memori. Mode yang disarankan adalah PiperNativeTTS: inferensi 100% native dalam proses (ONNX + jembatan espeak terkompilasi), tanpa Python, sekitar 10 kali lebih cepat daripada wrapper. Suara (.onnx + .onnx.json) tetap berupa file terpisah.

1. 01

   Menginstal dependensi

   Dokumentasi menyebutkan Node.js 18+ dan TypeScript 5+. Mode native tidak membutuhkan yang lain: cukup npm install. Mode wrapper klasik (PiperTTS via python3 -m piper) juga membutuhkan Python dan modul Piper. Pemilihan berdasarkan ID katalog dapat mengunduh model dan konfigurasinya ke models/.

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

2. 02

   Mulai cepat dengan suara katalog

   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

   Menggunakan model lokal

   Untuk suara yang diunduh manual, berikan jalur file ONNX. File .onnx.json pasangan harus diletakkan di sampingnya; Anda dapat menentukan configPath jika lokasinya berbeda.

   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 dan format

   synthesize() mengembalikan audio (Buffer), sampleRate dan text; outputFile juga menulis ke disk. Opsi: speakerId (multi-suara dan multi-gaya), lengthScale (> 1 memperlambat, < 1 mempercepat), noiseScale, noiseWScale, sentenceSilence, normalizeAudio, volume dan outputFormat (wav, raw, mp3, ogg atau opus). mp3 dan opus memiliki solusi JS murni; ogg membutuhkan FFmpeg. phonemize() dan synthesizeChunks() memberi akses tingkat rendah, kalimat per kalimat.

5. 05

   Wrapper lawas (PiperTTS)

   PiperTTS menjalankan python3 -m piper, 1 proses per sintesis: sekitar 10 kali lebih lambat, hanya untuk lingkungan tempat mesin native tidak berjalan. Membutuhkan Python dan modul 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");

   Halaman npm pipertts ↗Repositori GitHub pipertts ↗Dokumentasi dan contoh pipertts ↗