WSS
wss://api.modellix.ai/api/v1/live/openai/gpt-realtime-whisper
For authentication, handshake errors, and close codes shared by all Live models, see the Live Overview.
Quick Start
Prepare a short mono, 16-bit PCM WAV file at 24 kHz and setMODELLIX_API_KEY. Save the following code as whisper.py and run python whisper.py speech.wav. The script commits the whole file as one turn.
Python
Client Messages
session.update
Sendsession.update after session.created. The following fields belong inside session.
Use
gpt-realtime-whisper. The URL selects the model, and Modellix replaces this value with the upstream model identifier.Allowed values:
minimal, low, medium, high, xhigh. Lower values give earlier partial text; higher values usually improve accuracy.Must be
null. This model does not support voice activity detection, so your application detects the end of speech and sends input_audio_buffer.commit.audio.input.transcription.prompt.
Audio Input
Appends base64-encoded 24 kHz PCM16 mono audio in the
audio field. Chunks of 9,600 bytes hold 200 ms of audio.Server Messages
Server events are forwarded unchanged. Match transcript events to their turn byitem_id.
The final text in
transcript, with item_id and content_index. usage reports type: "duration" and seconds.Billing
Each completed turn produces one request record, based onusage.seconds from its completed event. Seconds are charged from the per-minute price without rounding up to a whole minute. Unit prices and invoices follow the console.
- Silence counts. Silence in a committed turn is part of the reported audio seconds.
- Uncommitted audio. If you disconnect before committing, Modellix commits the buffered audio once and waits up to 2 seconds for the result. If no usage arrives in that time, there is no charge for that audio.
- Disconnect after commit. A committed turn is billed if its result arrives within the same 2-second window. To keep the transcript as well, wait for
completedbefore closing.
Sessions and Limits
- This model is available only through its own Live endpoint. Other Live models cannot use it for attached transcription.
- WebSocket only. WebRTC and other upstream HTTP endpoints are not available through Modellix.
- Modellix closes any connection at its maximum connection duration with code
4408.