Text-to-Speech（TTS）API

Text-to-Speech（TTS）API を使うと、NovelAI の TTS 機能でテキストを音声化できます。スクリプトから読み上げキューへの追加、再生制御、TTS システムの管理が可能です。

基本的な使い方

すぐに読み上げる

api.v1.tts.speak で即時読み上げできます。

await api.v1.tts.speak('Hello! This text will be spoken aloud.');

この関数は、再生中の読み上げがあれば中断し、新しいテキストをすぐに読み上げます。

キューに追加する

再生中の読み上げを中断せずに、後ろへ追加するには api.v1.tts.queue を使います。

// 先に読み上げられる
await api.v1.tts.speak('First sentence.');

// その後に順番待ちとして追加される
await api.v1.tts.queue('Second sentence.');
await api.v1.tts.queue('Third sentence.');

キューに入れたテキストは、追加された順に読み上げられます。

再生コントロール

一時停止と再開

pause と resume で制御できます。

// 一時停止
await api.v1.tts.pause();

// 再開
await api.v1.tts.resume();

一時停止状態のトグル

再生中なら一時停止、停止中なら再開を切り替えるには togglePause を使います。

await api.v1.tts.togglePause();

停止

現在再生中・キュー待ちを含めて全て停止するには stop を使います。

await api.v1.tts.stop();

即時に停止し、キューもクリアされます。

参考