Authenticate Browser WebSocket Handshake

Problem: Browser WebSocket handshake returns 401 because you cannot set custom auth headers, or the protocol string is wrong. Solution: Pass Sec-WebSocket-Protocol as SukiAmbientAuth,<sdp_suki_token>,<session_id> with the token before the session ID. Use ambient_session_id for Ambient (/ws/stream) or transcription_session_id for Dictation (/ws/transcribe). Do not use SukiTranscriptionAuth.

This cookbook assumes you already have a valid sdp_suki_token and an open ambient or Dictation session ID.

TypeScript
Python

// Ambient browser handshake
const ambientWs = new WebSocket("wss://sdp.suki.ai/ws/stream", [
  `SukiAmbientAuth,${sdpSukiToken},${ambientSessionId}`,
]);

// Dictation uses the same auth scheme, different path and session id
const dictationWs = new WebSocket("wss://sdp.suki.ai/ws/transcribe", [
  `SukiAmbientAuth,${sdpSukiToken},${transcriptionSessionId}`,
]);

ambientWs.onerror = () => {
  console.error("WebSocket error. Check protocol order: token before session id.");
};

# Non-browser clients send headers instead of Sec-WebSocket-Protocol.
import websocket

# Ambient
ambient_ws = websocket.create_connection(
    "wss://sdp.suki.ai/ws/stream",
    header=[
        f"sdp_suki_token: {sdp_suki_token}",
        f"ambient_session_id: {ambient_session_id}",
        # Optional for standard partners; required for Bearer / Single Auth:
        f"sdp_provider_id: {sdp_provider_id}",
    ],
    timeout=60,
)

# Dictation: use transcription_session_id (not ambient_session_id)
dictation_ws = websocket.create_connection(
    "wss://sdp.suki.ai/ws/transcribe",
    header=[
        f"sdp_suki_token: {sdp_suki_token}",
        f"transcription_session_id: {transcription_session_id}",
        # Optional for standard partners; required for Bearer / Single Auth:
        f"sdp_provider_id: {sdp_provider_id}",
    ],
    timeout=60,
)

Common mistakes

Put the session ID before the token in the protocol string.
Use SukiTranscriptionAuth for Dictation. Both products use SukiAmbientAuth.

Other cookbooks

AmbientAPI

End Ambient After Streaming

Send RU9G, then end session.

5 min

DictationAPI

End Dictation with AUDIO_END

Use AUDIO_END, not ambient RU9G.

5 min

​Common mistakes

​Other cookbooks

​End Ambient After Streaming

​End Dictation with AUDIO_END

Common mistakes

Other cookbooks

End Ambient After Streaming

End Dictation with AUDIO_END