NativeTTSConfig
Configuration options for the NativeTTS provider.
Defined in: src/providers/tts/native/NativeTTS.ts:53
Configuration options for the NativeTTS provider.
Remarks
Extends the base TTSProviderConfig with options specific to the browser’s SpeechSynthesis API, including voice selection by name or language and a preference for local (offline) voices.
Example
const config: NativeTTSConfig = {
voiceName: 'Google US English',
voiceLang: 'en-US',
preferLocal: true,
rate: 1.2,
pitch: 0,
};
Extends
Properties
| Property | Type | Default value | Description | Inherited from | Defined in |
|---|---|---|---|---|---|
apiKey? | string | undefined | API key or authentication token for the provider. Remarks 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:67 |
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:86 |
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:75 |
model? | string | undefined | Model to use for text-to-speech synthesis. Remarks Provider-specific model identifier (e.g., 'aura-2' for Deepgram). | TTSProviderConfig.model | src/core/types/providers.ts:975 |
outputFormat? | string | undefined | Output audio format identifier. Remarks Provider-specific format string (e.g., 'linear16', 'mp3', 'opus'). | TTSProviderConfig.outputFormat | src/core/types/providers.ts:1000 |
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:992 |
preferLocal? | boolean | true | Whether to prefer locally-installed voices over network voices. Remarks Local voices are typically lower latency and work offline. When true, the provider will prefer voices where SpeechSynthesisVoice.localService is true, if no voice was matched by name or language. | - | src/providers/tts/native/NativeTTS.ts:86 |
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:984 |
sampleRate? | number | undefined | Sample rate for the output audio in Hz. Remarks Common values are 16000, 24000, and 48000. Must match the format capabilities of the chosen voice and model. | TTSProviderConfig.sampleRate | src/core/types/providers.ts:1009 |
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:95 |
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:967 |
voiceLang? | string | undefined | BCP 47 language tag to filter available voices (e.g., 'en-US', 'fr'). Remarks Used as a fallback when no voice matches voiceName or voice. Matches voices whose lang property starts with this value. | - | src/providers/tts/native/NativeTTS.ts:74 |
voiceName? | string | undefined (uses voice or falls back to 'default') | Voice name or URI to select from available browser voices. Remarks Performs a case-insensitive partial match against available voice names. If no match is found, falls back to language-based or default selection. | - | src/providers/tts/native/NativeTTS.ts:63 |