Skip to main content
POST
/
v1
/
sessions
{
  "id": "01234567-89ab-cdef-0123-456789abcdef",
  "avatar_id": "01234567-89ab-cdef-0123-456789abcdef",
  "livekit_url": "wss://<your-domain>.livekit.cloud",
  "started_at": "2022-01-01T00:00:00Z",
  "transport_type": "livekit"
}

Authorizations

​
x-api-key
string
header
required

Your Beyond Presence API Key.

Body

application/json
  • CreateLivekitSessionRequest
  • CreatePipecatSessionRequest

Request body to create a LiveKit speech-to-video session.

​
avatar_id
string
required

ID of avatar to use.

Examples:

"01234567-89ab-cdef-0123-456789abcdef"

​
livekit_url
string
required

URL of LiveKit server the avatar worker should connect to.

Examples:

"wss://<your-domain>.livekit.cloud"

​
livekit_token
string
required

The LiveKit token used to join your LiveKit room.

Examples:

"<your-livekit-token>"

​
transport_type
string
default:livekit

The session type.

Allowed value: "livekit"

Response

Created LiveKit Audio-to-Video Session with ID

  • LivekitSessionResponse
  • PipecatSessionResponse

Response model for a LiveKit speech-to-video session.

​
id
string
required

Unique identifier of the object in the database.

Examples:

"01234567-89ab-cdef-0123-456789abcdef"

​
avatar_id
string
required

ID of avatar to use.

Examples:

"01234567-89ab-cdef-0123-456789abcdef"

​
livekit_url
string
required

URL of LiveKit server the avatar worker should connect to.

Examples:

"wss://<your-domain>.livekit.cloud"

​
started_at
string
required

Start time in ISO 8601 format.

Examples:

"2022-01-01T00:00:00Z"

​
transport_type
string
default:livekit

The session type.

Allowed value: "livekit"
⌘I