Skip to main content

SmallestAITTS

Smallest AI text-to-speech (TTS) synthesizer.

Constructor

apiKey
string
Smallest AI API key. Defaults to the SMALLESTAI_API_KEY environment variable.
voice
string
Voice name for synthesis (e.g. 'magnus', 'lauren'). Takes precedence over voiceId. Default 'magnus'.
voiceId
string
Voice id; compatibility alias for voice. Ignored when voice is also set.
model
SmallestAITTSModel | string
TTS model id. Default 'lightning_v3.1'.
sampleRate
number
Output audio sample rate in Hz. Default 24000.
language
string
ISO 639-1 language code for the target voice. Default 'en'.
speed
number | null
Speaking rate multiplier; null uses the model default. Default null.
stream
boolean
Stream audio from the model. Default true.

close

Release any resources held by the provider.

closeEmitter

Close the emitter: drop all handlers and stop emitting. Waits up to 2 seconds for in-flight async handlers to settle before returning.

emit

event
string
required

getRuntimeConfig

returns
Record<string, any>

interrupt

Stop the current synthesis.

listenerCount

event
string
required
returns
number

off

event
string
required
handler
EventHandler
required

on

event
string
required
handler
EventHandler
required
returns
EventHandler

once

event
string
required
handler
EventHandler
required
returns
EventHandler

onFirstAudioByte

Register a callback fired when the first synthesized audio byte is emitted.
callback
FirstAudioByteCallback
required

removeAllListeners

event
string

synthesize

Synthesize and speak text on the active session.
text
any
required

SmallestAITTSModel

Supported Smallest AI TTS model names.