TTS.ai JavaScript SDK

Official JavaScript/Node.js SDK for TTS.ai - AI text-to-speech, voice cloning, and transcription.

Installation

npm install @ttsainpm/ttsai

Quick Start

const { TTSClient } = require('tts-ai');

const client = new TTSClient({ apiKey: 'sk-tts-YOUR_KEY' });

// Generate speech (OpenAI-compatible)
const audio = await client.generate({
  input: 'Hello world!',
  model: 'kokoro',
  voice: 'af_bella',
});
await client.saveToFile(audio, 'output.wav');

// Transcribe audio
const result = await client.transcribe({ file: 'recording.wav' });
console.log(result.text);

// List available voices
const voices = await client.listVoices('kokoro');

API Reference

new TTSClient(options)

• apiKey (required) - Your API key
• baseUrl - Default: https://tts.ai
• timeout - Request timeout in ms (default: 300000)
• maxRetries - Retries for rate limits (default: 3)

client.generate(options) - Generate speech

client.generateAsync(options) - Submit async job

client.pollResult(uuid, timeout) - Poll for result

client.listVoices(model?) - List voices

client.listModels() - List models

client.batchGenerate(options) - Batch TTS

client.batchResult(batchId) - Get batch result

client.transcribe(options) - Transcribe audio

License

MIT