Xentree Live

Xentree Live brings real-time voice and avatar interaction to the Xentree platform.

It is designed for immersive AI sessions with usage controls, transcript persistence, and personalization.

Core capabilities

start and end voice or avatar sessions

monitor remaining monthly live quota

update a user nickname for more natural interactions

store full transcript history

connect to realtime audio and avatar infrastructure

REST endpoints

Quota and profile

GET /api/live/quota

PATCH /api/live/nickname

Session lifecycle

POST /api/live/session/start

POST /api/live/session/heartbeat

POST /api/live/session/end

Transcript storage

POST /api/live/transcripts

GET /api/live/transcripts

GET /api/live/transcripts/{transcript_id}

Realtime architecture

For browser-based realtime interactions, Xentree Live uses a dedicated socket endpoint:

Socket endpoint: wss://orchstr.xentree.com

Representative event types include:

start-session

end-session

audio-input

audio-response

session-started

session-ended

avatar-expression

Example start request

{
  "session_type": "voice"
}

Example transcript payload

{
  "session_started_at": "2026-04-16T10:00:00Z",
  "session_ended_at": "2026-04-16T10:05:00Z",
  "transcripts": [
    {
      "role": "user",
      "text": "Hello Xentree",
      "timestamp": "2026-04-16T10:00:03Z"
    },
    {
      "role": "ai",
      "text": "Hi, how can I help you today?",
      "timestamp": "2026-04-16T10:00:05Z"
    }
  ]
}

Quota behavior

Live usage is tracked in seconds and is evaluated against the user’s plan entitlements. If the quota is exceeded, the API can return a limit-related error and the client should gracefully end the session.

Core capabilities#

REST endpoints#

Quota and profile#

Session lifecycle#

Transcript storage#

Realtime architecture#

Example start request#

Example transcript payload#

Quota behavior#