Skip to main content
Product: Visual Intelligence — Live Audio Transcription Use case: Real-time speech-to-text on a live audio stream. For one-off file transcription, see Audio File Transcription. Mode: Client-Push (your client opens a WebSocket and pushes audio frames directly — best for browser microphone or mobile app). For backend-controlled streaming, see the Server-Pull variant. Host: https://mavi-backend.memories.ai/serve/api/v2 Auth: Authorization: sk-mavi-... (no Bearer prefix)
Access Required: To use this API endpoint, please contact us at contact@memories.ai to enable stream processing features for your account.
This endpoint provides a direct WebSocket proxy to ElevenLabs or AssemblyAI real-time speech-to-text services. Your client connects to our WebSocket gateway, and we transparently forward all frames to/from the upstream provider. You send audio, you receive transcription results — in real time.
When to use this vs /audio-stream/start?
  • Use this WebSocket endpoint when your client can send audio directly (e.g., browser microphone, mobile app).
  • Use /audio-stream/start when you have a stream URL (RTMP/RTSP/HLS) and want the server to pull and process it for you.
Pricing (varies by provider):Billed every 5 seconds of audio streamed through the WebSocket connection.

Connection

Authentication

Two options (pick one):
  1. Query parameter: ?api_key=sk-mavi-...
  2. HTTP header: Authorization: sk-mavi-... (sent during WebSocket handshake)

Error Codes during Handshake

Provider-Specific Parameters

ElevenLabs

All parameters are passed as URL query strings and forwarded to wss://api.elevenlabs.io/v1/speech-to-text/realtime. Audio format: Send audio as JSON text frames:
End session: Send a commit message:

AssemblyAI

All parameters are passed as URL query strings and forwarded to wss://streaming.assemblyai.com/v3/ws. Audio format: Send raw PCM audio as binary frames. End session: Send a text frame:

Data Flow

Code Examples

Response Messages

All transcription results from the upstream provider are forwarded to your client as-is (verbatim JSON). The message format depends on the selected provider.

ElevenLabs Response Example

AssemblyAI Response Example

Important Notes

  • Per-provider billing: AssemblyAI is billed at 0.15/hour,ElevenLabsat0.15/hour, ElevenLabs at 0.39/hour. Charges are calculated every 5 seconds of audio streamed.
  • Transparent proxy: All frames are forwarded as-is in both directions. The gateway does not modify any data.
  • Concurrent connections: Subject to your account’s stream processing limits.
  • Unsupported parameters are ignored: If you pass a parameter that doesn’t apply to the selected provider, the provider will silently ignore it.
  • Recommended audio format: 16kHz sample rate, 16-bit signed little-endian, mono channel (PCM s16le).