---
title: "Open a realtime session"
method: GET
path: "/v1/realtime"
tags: ["realtime"]
---

# Open a realtime session

`GET /v1/realtime`

Upgrades to a websocket and relays an OpenAI-compatible realtime (speech-to-speech) session to the provider that owns the model named in the ?model= query parameter. Provider credentials are injected by the gateway. Passing ?call_id= instead attaches to an existing WebRTC/SIP call as a sideband channel; calls created through this gateway instance are routed automatically, others need explicit model (and provider) parameters.

## Query parameters

- `model` string
- `provider` string
- `call_id` string

## Other responses

- `101` — Switching Protocols
- `400` — Bad Request
- `401` — Unauthorized
- `404` — Not Found
- `429` — Too Many Requests
- `501` — Not Implemented
- `502` — Bad Gateway

## Changes

- **2026-08-22** `496ff50bdfef` — 6 info
  - added the optional property `error/provider` to the response with the `400` status
  - added the optional property `error/provider` to the response with the `401` status
  - added the optional property `error/provider` to the response with the `404` status
  - added the optional property `error/provider` to the response with the `429` status
  - …2 more
- **2026-07-07** `e6765808efd4` — 4 info
  - added the new optional `query` request parameter `call_id`
  - the `query` request parameter `model` became optional
  - added the non-success response with the status `404`
  - added the non-success response with the status `429`
- **2026-06-16** `016604930a3c` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/enterpilot/apis/gomodel-api/changes/v1/realtime/get.md)

---

[API](https://skmtc.dev/enterpilot/apis/gomodel-api.md) · [All operations](https://skmtc.dev/enterpilot/apis/gomodel-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/enterpilot/gomodel-api/revisions/496ff50bdfef/schema)