Skip to main content
WSS
/
v1
/
stt
/
deepgram
/
nova:2
Messages
bearer
type:http

API key issued by SLNG. Pass as Authorization: Bearer <token> in the WebSocket upgrade request headers.

method
type:string

GET

headers
type:object
X-World-Part-Override
type:enum

Target world part override. Auto-selected if not provided. Available world parts: na, eu.

Available options: na, eu
Init Request
type:object

Initialize a Deepgram STT session with provider-specific recognition configuration.

Binary Audio Frame
type:string

Stream raw binary PCM audio frames to be transcribed. Sent as binary WebSocket frames (NOT JSON). Recommended chunk size is 8192 bytes (~256ms at 16kHz linear16). Start streaming immediately after the init message — do not wait for the Metadata response.

Finalize Message
type:object

Force-finalize buffered audio tokens without closing the connection.

Close Message
type:object

Signal end of audio stream and close the connection.

Keepalive Message
type:object

Keep the WebSocket connection alive during silence.

Metadata
type:object

Deepgram session metadata. Sent when the backend connects and again after the session ends with final statistics. This is informational — do not wait for it before streaming audio.

Results
type:object

Deepgram transcription result — partial or final, determined by is_final.

Error
type:object

Error from the Deepgram backend or gateway.