SmallestTTSConfig
Configuration for the SmallestTTS provider.
Defined in: src/providers/tts/smallest/SmallestTTS.ts:83
Configuration for the SmallestTTS provider.
Remarks
Provide either apiKey (for direct API access) or proxyUrl (for server-side proxy). At least one must be set. If both are provided, proxyUrl takes precedence and the API key is not sent to the client. The voiceId is always required.
Example
// Direct API access
const config: SmallestTTSConfig = {
apiKey: 'sk_xxxxxxxxxxxx',
voiceId: 'meher',
model: 'lightning_v3.1',
outputFormat: 'wav',
};
// Via proxy server
const proxyConfig: SmallestTTSConfig = {
proxyUrl: 'http://localhost:3001/api/proxy/smallest',
voiceId: 'meher',
};
See
- SmallestTTSModel - Available model options.
- SmallestTTSFormat - Available audio format options.
Extends
Properties
| Property | Type | Default value | Description | Overrides | Inherited from | Defined in |
|---|---|---|---|---|---|---|
apiKey? | string | () => Promise<string> | undefined | API key or authentication token for the provider. Remarks Can be a static string or an async factory function that returns a fresh token on each call. Use a factory for short-lived tokens (e.g. Deepgram JWTs) so each WebSocket connection gets a valid credential. For client-side usage, consider using a proxy server to keep API keys secure. The SDK provides Express, Next.js, and Node adapters for this purpose. | - | TTSProviderConfig.apiKey | src/core/types/providers.ts:71 |
authType? | "token" | "bearer" | Provider-specific (typically 'token' for Deepgram, ignored for REST providers) | Authentication type for providers that support multiple auth mechanisms. Remarks Controls how the apiKey is sent to the provider: - 'token' — WebSocket subprotocol ['token', apiKey] or header Authorization: Token <key>. This is the default for Deepgram providers. - 'bearer' — WebSocket subprotocol ['bearer', token] or header Authorization: Bearer <token>. Use this for OAuth tokens or providers that expect Bearer auth. REST/SDK providers (Anthropic, OpenAI) handle auth through their SDK constructors and ignore this field. | - | TTSProviderConfig.authType | src/core/types/providers.ts:115 |
debug? | boolean | false | Whether to enable debug logging for this provider. Remarks When true, the provider emits detailed internal logs. This is separate from the SDK-level LoggingConfig. | - | TTSProviderConfig.debug | src/core/types/providers.ts:126 |
endpoint? | string | undefined | Custom endpoint URL to override the provider’s default API endpoint. Remarks Useful for self-hosted instances, proxy servers, or development environments. | - | TTSProviderConfig.endpoint | src/core/types/providers.ts:79 |
language? | string | 'en' (API default) | Language of the input text. Remarks An ISO 639-1 code matching the chosen voice, e.g. 'en', 'hi', or 'es'. Lightning v3.1 supports 12 languages: en, hi, mr, kn, ta, bn, gu, te, ml, pa, or, and es. | - | - | src/providers/tts/smallest/SmallestTTS.ts:140 |
maxRetries? | number | 3 | Maximum number of retries for failed API requests. | - | - | src/providers/tts/smallest/SmallestTTS.ts:147 |
model? | SmallestTTSModel | 'lightning_v3.1' | The TTS model to use. See SmallestTTSModel | TTSProviderConfig.model | - | src/providers/tts/smallest/SmallestTTS.ts:100 |
outputFormat? | SmallestTTSFormat | 'wav' | The audio output format. See SmallestTTSFormat | TTSProviderConfig.outputFormat | - | src/providers/tts/smallest/SmallestTTS.ts:108 |
pitch? | number | undefined | Pitch adjustment in semitones. Remarks Values from -20 to +20 semitones. Not all providers support pitch adjustment. | - | TTSProviderConfig.pitch | src/core/types/providers.ts:1182 |
proxyUrl? | string | undefined | URL of a CompositeVoice proxy server endpoint for this provider. Remarks When set, requests are routed through the proxy which injects the real API key server-side. This keeps API keys out of the browser. For WebSocket providers the HTTP URL is automatically converted to ws(s)://. At least one of apiKey or proxyUrl must be set for providers that require authentication (all except NativeSTT, NativeTTS, and WebLLM). Example proxyUrl: 'http://localhost:3000/api/proxy/deepgram' | - | TTSProviderConfig.proxyUrl | src/core/types/providers.ts:97 |
rate? | number | undefined | Speech rate multiplier. Remarks Values from 0.25 (quarter speed) to 4.0 (quadruple speed), where 1.0 is normal speed. Not all providers support rate adjustment. | - | TTSProviderConfig.rate | src/core/types/providers.ts:1174 |
sampleRate? | SmallestTTSSampleRate | 44100 (API default) | Sample rate of the output audio in Hz. Remarks One of 8000, 16000, 24000, or 44100. | TTSProviderConfig.sampleRate | - | src/providers/tts/smallest/SmallestTTS.ts:118 |
speed? | number | 1.0 (API default) | Speech speed multiplier. Remarks Accepted range is 0.5 to 2.0, where 1.0 is normal speed. | - | - | src/providers/tts/smallest/SmallestTTS.ts:128 |
timeout? | number | undefined | Request timeout in milliseconds. Remarks Applies to HTTP requests (REST providers) and connection establishment (WebSocket providers). Set to 0 for no timeout. | - | TTSProviderConfig.timeout | src/core/types/providers.ts:135 |
voice? | string | undefined | Voice ID or name to use for synthesis. Remarks Provider-specific voice identifier. For example, Deepgram uses identifiers like 'aura-asteria-en', while ElevenLabs uses voice IDs. | - | TTSProviderConfig.voice | src/core/types/providers.ts:1157 |
voiceId | string | undefined | The voice to use for synthesis. Remarks Required. A catalog voice ID (e.g. 'meher', 'magnus', 'olivia') or a cloned voice ID. List available voices in the Waves console. | - | - | src/providers/tts/smallest/SmallestTTS.ts:92 |