v1

latestOpenAPI 3.0.12026-07-2649123153.6 KB

/ws

Stream audio for transcription

Opens a WebSocket to stream audio for real-time transcription. Browser clients authenticate with the Sec-WebSocket-Protocol header; non-browser clients send sdp_suki_token and transcription_session_id as HTTP headers on the upgrade request.

get/ws/transcribe

Headers

Sec-WebSocket-Protocolstring

Required FOR BROWSER CLIENTS ONLY. Sent during WebSocket handshake. Browsers must use the same subprotocol the grpc-wsproxy maps to Authorization: 'SukiAmbientAuth,<sdp_suki_token>,<transcription_session_id>' (comma-separated; token second, transcription session id third). Other names (e.g. SukiTranscriptionAuth) are not mapped and typically yield 401.

transcription_session_idstring required

Required for non-browser clients only. UUID from Create Transcription Session.

sdp_provider_idstring

Example:provider-123

Optional for standard partners.

Required for:

Bearer authentication. Use the same provider_id returned by the Login or Register API.
Single Auth Token authentication. Include the same provider_id on every request as sdp_provider_id.

Response

OK - May indicate successful stream processing or completion (e.g., sending 'EOF' message). Specific meaning depends on implementation after handshake.

string required