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)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/startwhen 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):- Query parameter:
?api_key=sk-mavi-... - 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 towss://api.elevenlabs.io/v1/speech-to-text/realtime.
Audio format: Send audio as JSON text frames:
AssemblyAI
All parameters are passed as URL query strings and forwarded towss://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.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).
