---
title: "Connect to realtime WebSocket"
method: GET
path: "/v1/realtime"
tags: ["Realtime"]
---

# Connect to realtime WebSocket

`GET /v1/realtime`

## Request

- Base URL: `https://api.tokenlab.sh`
- URL: `https://api.tokenlab.sh/v1/realtime`
- Auth: HTTP bearer

Returns realtime endpoint metadata for normal HTTP GET requests. WebSocket clients use the same path with `?model={model}` and Bearer API key authentication to open realtime speech or multimodal sessions. This public surface is a TokenLab WebSocket subset of OpenAI Realtime; it does not expose its REST helper endpoints such as client secrets, translation client secrets, Calls, or legacy beta session creation.

## Query parameters

- `model` string

## Response `200`

Realtime endpoint metadata returned for non-WebSocket GET requests

- object
  - `object` string, required
  - `websocket_url` string, required
  - `protocol` string, required

## Other responses

- `101`: WebSocket connection established
- `400`: Bad Request - Invalid input
- `401`: Unauthorized - Invalid or missing API key
- `402`: Payment Required - Insufficient balance or quota exceeded
- `429`: Rate Limit Exceeded
- `500`: Internal Server Error

---

[API](https://skmtc.dev/tokenlab/apis/tokenlab-ai-gateway.md) · [All operations](https://skmtc.dev/tokenlab/apis/tokenlab-ai-gateway/llms.txt) · [OpenAPI document](https://skmtc.dev/tokenlab/apis/tokenlab-ai-gateway/revisions/3208bfbcda22?raw)