Realtime sessions
Authorization: Bearer $ORQ_API_KEY in the upgrade request. model is required: a missing value returns 400, an unknown model 404, and a model without a realtime protocol 400.
The endpoint routes Grok Voice and GPT-Live models. See supported realtime models.
A session counts against the workspace’s rate limits and budgets when it connects. An exhausted limit rejects the upgrade; see Errors.
Grok Voice
The gateway proxies the OpenAI Realtime event protocol: JSON events in both directions and binary frames for audio. The Grok Voice constraints, audio formats, and billing are listed under Realtime models.GPT-Live
Connect towss://my.orq.ai/v3/router/realtime?model=openai/gpt-live-1.1 with a key that grants realtime.execute. Send a Live session.start event first.
session.started before sending base64 audio in session.input_audio.append. Play audio from session.output_audio.delta. Send session.close and wait for session.closed to receive final usage. Run delegated work in the calling application. OpenAI Live WebSocket protocol
WebRTC and standby
Send an SDP offer toPOST /v3/router/live/sessions with the same permission. Apply transport.sdp from the 201 response as the remote answer. Use the oai-events data channel for Live events.
wake_policy starts inference when speech is detected. idle_timeout_s returns the session to standby after inactivity. GPT-Live is billed by the second at $0.05 per active minute and $0.02 per standby minute. WebSocket sessions use the active rate. OpenAI Live session pricing
Responses over WebSocket
openai-beta.responses.v1 subprotocol and Authorization: Bearer $ORQ_API_KEY. Each client message creates or steers a response; the server streams the same events as an HTTP streaming request.
- One turn at a time. Send the next
response.createafter the previous turn’s terminal event. stream_idlabels the turn and correlates the events that belong to it.response.steertakes aprevious_response_idandinput, and steers the live turn that produced that response. A failure arrives as aresponse.steer.failedevent with a code such asresponse_not_foundorsteering_not_supported.- Connection lifetime is 30 minutes; the server sends a
connection_duration_exceedederror event and closes the socket. Reconnect and continue withprevious_response_id, which fails withprevious_response_not_foundwhen the response has expired.