Create a realtime session

Internal testing. Realtime is available only to enabled workspaces and may change before general availability. Use a standard Gateway API key; OAuth access is not available during testing.

Create a session with POST https://api.phaseo.app/v1/realtime/sessions. The response includes a short-lived client secret and the WebSocket relay URL to connect to.

curl https://api.phaseo.app/v1/realtime/sessions \
  -H "Authorization: Bearer $PHASEO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai/gpt-realtime",
    "voice": "alloy",
    "instructions": "Be concise and helpful."
  }'

The create request accepts:

model — required model ID
provider — optional provider override
voice — optional provider-supported voice
instructions — optional session instructions
metadata — optional application metadata

Use the returned connect.url and client_secret to open the relay. The relay uses WebSocket transport and requires an upgrade request rather than a normal HTTP GET. Realtime sessions reserve credits when created and settle against authoritative usage. Session duration, idle time, and concurrent-session limits are included in the response’s billing object.

Last modified on July 26, 2026

List organisations Generate a video

API Guides

API Reference

Create a realtime session