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 Authorization: Bearer header during the WebSocket handshake.

Required header: OpenAI-Beta: realtime=v1

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.

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

Responses

200

WebSocket connection established. Communicate using OpenAI Realtime API event format.

No content

400

Bad Request - The request is malformed. This could be due to missing parameters, invalid formats, or routing errors.

Note: the 400 body shape is not uniform. Validation errors return the structured object below, but routing/model errors may instead return a plain string: { "error": "<message>" }. A few endpoints (e.g. some file operations) may return a plain-text body rather than JSON.

application/json

401

Invalid Credentials - Your API key is invalid, missing, or disabled. Check your credentials.

Note: the 401 error body uses code, message, param, and type (there is no status field), and type is invalid_request_error.

application/json

get/v1/realtime

HTTPcURLJavaScriptPython

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

No content