realtime

Create a realtime WebRTC call

Changed on

OpenAI-compatible WebRTC SDP exchange. Accepts a raw application/sdp offer with the model in the ?model= query parameter, or a multipart form with sdp and session (JSON) fields. The gateway routes by model, injects provider credentials, and relays the SDP answer; the Location header carries the created call id. Media flows directly between the client and the provider, so usage is recorded by a gateway-side sideband observer when usage tracking is enabled.

post/v1/realtime/calls

Request

  • Base URL
    http://localhost:8080
  • URL
    http://localhost:8080/v1/realtime/calls
  • Auth
    HTTP bearer

Query parameters

modelstring

Model that owns the call (required for application/sdp offers)

providerstring

Optional provider hint

Request body multipart/form-data

string required

Response

SDP answer

string required

Changes

    • warning

      added the new internal_error enum value to the / response property for the response status (media type: application/sdp)

    • warning

      added the new internal_error enum value to the / response property for the response status (media type: application/json)

    • warning

      added the new internal_error enum value to the / response property for the response status (media type: application/sdp)

    • warning

      added the new internal_error enum value to the / response property for the response status (media type: application/json)

    • warning

      added the new internal_error enum value to the / response property for the response status (media type: application/sdp)

    • warning

      added the new internal_error enum value to the / response property for the response status (media type: application/json)

    • warning

      added the new internal_error enum value to the / response property for the response status (media type: application/sdp)

    • warning

      added the new internal_error enum value to the / response property for the response status (media type: application/json)

    • warning

      added the new internal_error enum value to the / response property for the response status (media type: application/sdp)

    • warning

      added the new internal_error enum value to the / response property for the response status (media type: application/json)

    • warning

      added the new permission_error enum value to the / response property for the response status (media type: application/sdp)

    • warning

      added the new permission_error enum value to the / response property for the response status (media type: application/json)

    • warning

      added the new permission_error enum value to the / response property for the response status (media type: application/sdp)

    • warning

      added the new permission_error enum value to the / response property for the response status (media type: application/json)

    • warning

      added the new permission_error enum value to the / response property for the response status (media type: application/sdp)

    • warning

      added the new permission_error enum value to the / response property for the response status (media type: application/json)

    • warning

      added the new permission_error enum value to the / response property for the response status (media type: application/sdp)

    • warning

      added the new permission_error enum value to the / response property for the response status (media type: application/json)

    • warning

      added the new permission_error enum value to the / response property for the response status (media type: application/sdp)

    • warning

      added the new permission_error enum value to the / response property for the response status (media type: application/json)