Realtime

Realtime WebRTC SDP exchange

Negotiates a WebRTC peer connection with the realtime provider on behalf of the client. Implements the OpenAI GA /realtime/calls contract: the request body is multipart/form-data with sdp (client SDP offer) and session (JSON session description containing model).

Bifrost forwards the offer to the upstream provider, returns the upstream SDP answer to the client, and pipes RTP media between the two peers for the lifetime of the session.

Inference auth applies (Bearer/Basic/Virtual Key/API Key).

POST
/v1/realtime/calls
AuthorizationBearer <token>

Bearer token authentication. Use your MPilot virtual-key JWT or admin JWT. Virtual keys (prefixed with sk-bf-) can also be passed here.

In: header

sdpstring

Client-generated SDP offer

sessionstring

JSON-encoded session descriptor. session.model is required and must be in provider/model form.

Response Body

curl -X POST "https://loading/{AI_GATEWAY_URL}/v1/realtime/calls" \  -F sdp="string" \  -F session="string"
"string"
{
  "event_id": "string",
  "type": "string",
  "is_bifrost_error": true,
  "status_code": 0,
  "error": {
    "type": "string",
    "code": "string",
    "message": "string",
    "param": "string",
    "event_id": "string"
  },
  "extra_fields": {
    "provider": "openai",
    "model_requested": "string",
    "request_type": "string"
  }
}
Empty
Empty
On this page

On this page

No Headings