After you create an ambient session and seed the session context, you can stream audio to the session using theDocumentation Index
Fetch the complete documentation index at: https://developer.suki.ai/llms.txt
Use this file to discover all available pages before exploring further.
GET /ws/stream endpoint for ambient sessions or the GET /ws/transcribe endpoint for dictation sessions.
Both endpoints use WebSocket to stream audio.
This guide applies to: Direct HTTP and WebSocket integrations with Suki for Partner Ambient, Form Filling, and Dictation APIs.
| Endpoint | Purpose | API reference |
|---|---|---|
GET ws/stream | Stream PCM audio into an ambient and a form filling session for note generation and related processing | Audio streaming for ambient and form filling sessions |
GET /ws/transcribe | Stream PCM_S16LE audio into a dictation (transcription) session for real-time text | Stream audio to dictation session |
https://sdp.suki-stage.com and wss://sdp.suki-stage.com). Your partnership team confirms which host and credentials apply.
Ambient Streaming
Stream PCM audio into an ambient session for note generation and related processing. Use this endpoint when you already have an ambient session and want to push live audio for that session.
Dictation Streaming
Stream PCM_S16LE audio into a dictation (transcription) session for real-time text. Use this endpoint when you have a dictation session and want to push audio for that session.
Side-by-side comparison
| Topic | Ambient Streaming | Dictation Streaming |
|---|---|---|
| Endpoint | GET /ws/stream | GET /ws/transcribe |
Browser Sec-WebSocket-Protocol | SukiAmbientAuth,<ambient_session_id>,<sdp_suki_token> | SukiAmbientAuth,<sdp_suki_token>,<transcription_session_id> |
| Non-browser headers | sdp_suki_token, ambient_session_id | sdp_suki_token, transcription_session_id |
| Audio field name | data (Base64 PCM) | audioData (Base64 PCM_S16LE) |
| Start-of-stream | START_TIME required first | No START_TIME in the dictation contract documented here |
| End-of-stream | AUDIO with data: RU9G (Base64 of bytes EOF) | EVENT with event: AUDIO_END |
| Control messages | type: EVENT, event: enum (see FAQ) | EVENT / AUDIO_END for end of audio |
Next steps
Audio Streaming API Reference
Learn more about streaming audio to an ambient session.
Dictation Streaming API Reference
Learn more about streaming audio to a dictation session.
Audio Capture & Streaming FAQs
Learn more about the audio capture and streaming FAQ.