audio

Create a realtime voice session

Create an ephemeral realtime voice session. Returns a short-lived client secret for the WebRTC connection plus a reservation_id that must be settled with finalizeRealtimeSession when the call ends.

post/audio/realtime/sessions

Request

  • Base URL
    https://api.krater.ai/v1
  • Auth
    HTTP bearer

Request body

voice'alloy' | 'ash' | 'coral' | 'echo' | 'shimmer' | 'verse'

Voice for the assistant's audio output.

instructionsstring

System instructions for the voice assistant.

Response

Ephemeral session credentials.

client_secretstring

Ephemeral key used as Bearer auth for the WebRTC SDP exchange.

reservation_idstring

Credit reservation to settle via /audio/realtime/finalize when the session ends.

session_idstring
expires_atinteger

Unix timestamp when the client secret expires.

created_atstring date-time
voicestring
modelstring
webrtc_urlstring uri

WebRTC SDP exchange endpoint.

Changes

No recorded changes to this operation across all 1 revision of this API.