Kayıtlardan
sese.

pipertts ile Node.js projesinde Piper kullanın

pipertts, Piper uygulamasını Node.js ortamına taşır; dosya yazma veya bellek içi ses destekler. Önerilen mod PiperNativeTTS olur: %100 yerel süreç içi çıkarım (ONNX ve derlenmiş espeak köprüsü), Python gerektirmez, sarmalayıcıdan yaklaşık 10 kat daha hızlıdır. Sesler (.onnx + .onnx.json) ayrı dosyalar olarak kalır.

1. 01

   Bağımlılıkları kurun

   Belgeler Node.js 18+ ve TypeScript 5+ gerektirir. Yerel mod başka bir şey istemez: normal bir npm install yeterlidir. Klasik sarmalayıcı modu (python3 -m piper üzerinden PiperTTS) ayrıca Python ve Piper modülünü gerektirir. Katalog kimliğine göre seçim, modeli ve yapılandırmasını models/ klasörüne indirebilir.

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

2. 02

   Katalog sesiyle hızlı başlangıç

   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

   Yerel model kullanın

   Manuel olarak indirdiğiniz bir ses için ONNX dosyasının yolunu verin. İlişkili .onnx.json dosyası yanında olmalıdır; konumu farklıysa configPath belirtebilirsiniz.

   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 ve biçimler

   synthesize() audio (Buffer), sampleRate ve text döndürür; outputFile ayrıca diske yazar. Seçenekler: speakerId (çok sesli ve çok tarzlı), lengthScale (> 1 yavaşlatır, < 1 hızlandırır), noiseScale, noiseWScale, sentenceSilence, normalizeAudio, volume ve outputFormat (wav, raw, mp3, ogg veya opus). mp3 ve opus için saf JS çözümleri vardır; ogg için FFmpeg gerekir. phonemize() ve synthesizeChunks() cümle cümle düşük seviyeli erişim sağlar.

5. 05

   Eski sarmalayıcı (PiperTTS)

   PiperTTS, sentez başına bir işlemle python3 -m piper çalıştırır: yaklaşık 10 kat daha yavaştır, yalnızca yerel motorun çalışmadığı ortamlara ayrılmalıdır. Python ve Piper modülünü gerektirir.

   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");

   npm üzerinde pipertts ↗pipertts GitHub deposu ↗pipertts belgeleri ve örnekleri ↗