SUsuki
/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

Request

  • Base URL
    https://sdp.suki.ai
  • URL
    https://sdp.suki.ai/ws/transcribe
  • Auth
    API key in header sdp_suki_token

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

Changes

No recorded changes to this operation across all 2 revisions of this API.