---
title: "Create and start a Real-Time API Session"
method: POST
path: "/v1/session"
tags: ["session"]
---

# Create and start a Real-Time API Session

`POST /v1/session`

With the Beyond Presence Real-Time API you are able to turn audio and text into
hyper-realistic avatars in real-time.

Once a session is created, the selected avatar will automatically join the
WebRTC room and will start streaming audio and video to the user.

## Request body

- SessionRequestModel — Represents a request to create a Beyond Presence Real-Time API session.
  - `avatar_id` string, required — The ID of the avatar to use in the session.
  - `livekit_url` string, required — The LiveKit URL you chose when creating your LiveKit project.
  - `livekit_token` string, required — The LiveKit token used to join your LiveKit room.

## Response `201`

Successful Response

- SessionResponseModel — Represents a Beyond Presence Real-Time API session.
  - `id` string, required — The unique identifier (ID) of the session.
  - `created_at` string, date-time, required — The timestamp of when the session was created.
  - `avatar_id` string, required — The ID of the avatar used in the session.
  - `livekit_url` string, required — The LiveKit URL you chose when creating your LiveKit project.
  - `livekit_token` string, required — The LiveKit token used to join your LiveKit room.

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/bey-dev/apis/fastapi.md) · [All operations](https://skmtc.dev/bey-dev/apis/fastapi/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/bey-dev/fastapi/revisions/b999e8704c12/schema)