Text to Speech

Lightning v2 WebSocket

View as Markdown
The Lightning v2 WebSocket API provides real-time text-to-speech streaming capabilities with high-quality voice synthesis. This API uses WebSocket to deliver audio chunks as they're generated, enabling low-latency audio playback without waiting for the entire audio file to process. Perfect for interactive applications, voice assistants, and real-time communication systems that require immediate audio feedback. For an end-to-end example of how to use the Lightning v2 WebSocket API, check out [Text to Speech (WS) Example](https://github.com/smallest-inc/waves-examples/tree/main/lightning_v2/ws_streaming)

Handshake

WSS
wss://api.smallest.ai/waves/v1/lightning-v2/get_speech/stream

Authentication

AuthorizationBearer

Header authentication of the form Bearer <token>

Headers

AuthorizationstringRequired

Bearer token for authentication. Format: Bearer YOUR_API_KEY

Send

LightningV2TtsRequestobjectRequired

Send a JSON message with voice_id, text, and optional parameters to generate speech audio.

Receive

LightningV2TtsResponseobjectRequired
Receive audio data chunks and completion status from the server.