Sessions

Create Live Session (WebSocket)

get

Establishes a WebSocket connection to start a new GPT-Live session for real-time voice and text conversations using OpenAI's GPT-Live models.

Connection URL:

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

Authentication: The request is authenticated before the WebSocket upgrade. Pass your FastRouter API key via Authorization: Bearer header during the handshake.

Supported models: openai/gpt-live-1 (default) and other OpenAI GPT-Live models.

Authorizations

AuthorizationstringRequired

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

Format: Authorization: Bearer YOUR_API_KEY

Query parameters

modelstringOptional

The GPT-Live model to use. Defaults to gpt-live-1 when omitted.

Default: gpt-live-1Example: openai/gpt-live-1

Responses

200

WebSocket connection established. Communicate using OpenAI's GPT-Live session event format (session.start, session.update, response.create, etc.).

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/live/sessions

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

No content

Fork Live Session (WebSocket)

get

Establishes a WebSocket connection that forks a new GPT-Live session from a previously stored session, continuing its conversation state.

Connection URL:

wss://api.fastrouter.ai/v1/live/sessions/{session_id}/fork?model=MODEL_ID

Authentication: The request is authenticated before the WebSocket upgrade. Pass your FastRouter API key via Authorization: Bearer header during the handshake.

Supported models: openai/gpt-live-1 (default) and other OpenAI GPT-Live models.

Authorizations

AuthorizationstringRequired

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

Format: Authorization: Bearer YOUR_API_KEY

Path parameters

session_idstringRequired

The stored GPT-Live session id to fork from.

Query parameters

modelstringOptional

The GPT-Live model to use. Defaults to gpt-live-1 when omitted.

Default: gpt-live-1Example: openai/gpt-live-1

Responses

200

WebSocket connection established. Communicate using OpenAI's GPT-Live session event format (session.start, session.update, response.create, etc.).

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/live/sessions/{session_id}/fork

GET /v1/live/sessions/{session_id}/fork HTTP/1.1
Host: api.fastrouter.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

No content