Realtime

Create Realtime Session (WebSocket)

get

Establishes a WebSocket connection for real-time audio and text conversations using OpenAI's Realtime API models.

Connection URL:

wss://api.fastrouter.ai/v1/realtime?model=MODEL_ID

Authentication: Pass your FastRouter API key via the Authorization: Bearer header or x-api-key header during the WebSocket handshake.

Required header: Include OpenAI-Beta: realtime=v1 in the connection request.

Protocol: After connection, send and receive JSON messages following OpenAI's Realtime API event format:

• session.update — Configure session parameters

• input_audio_buffer.append — Send audio data

• input_audio_buffer.commit — Commit audio for processing

• response.create — Request a response

• conversation.item.create — Add conversation items

Usage tracking: Token usage and costs are tracked per session and billed upon session close.

Supported models: openai/gpt-4o-realtime-preview-2024-12-17 and other OpenAI realtime models.

Authorizations

bearerAuth

AuthorizationstringRequired

FastRouter API Key. Get yours at https://fastrouter.ai

Format: Authorization: Bearer YOUR_API_KEY

Query parameters

modelstringOptional

The realtime model to use. Defaults to gpt-4o-realtime-preview-2024-12-17.

Default: gpt-4o-realtime-preview-2024-12-17Example: openai/gpt-4o-realtime-preview-2024-12-17

Responses

101

WebSocket connection established successfully. Communicate using OpenAI Realtime API event format (JSON messages over WebSocket).

400

Bad Request — Invalid model or failed to upgrade to WebSocket

application/json

401

Invalid Credentials - Your API key is invalid, disabled, or your OAuth session has expired. Check your credentials.

application/json

get

/realtime

HTTPcURLJavaScriptPython

GET /api/v1/realtime HTTP/1.1
Host: api.fastrouter.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

No content