Speech-to-Video Quickstart

Speech-to-Video API is ideal if you have an existing voice agent or need full control over your infrastructure and user data.For zero-infrastructure no-code deployment, use Managed Agents instead.

Part 1: Set Up Beyond Presence

Go to the Beyond Presence Studio and sign up with either your email or your Google account.

Create an API Key

Go to the API Keys tab in your account settings, create a new API key, and save it somewhere.

Create an API Key

Learn more about how to use API keys for using the Beyond Presence API.

Select an Avatar

Go to the Avatars tab in the Studio and select an avatar you want to use in your application. Then hover the avatar, open the ”…” menu, click “Copy ID”, and save it.

Default Avatars

Explore our stock avatars that can be used immediately.

Part 2: Create a LiveKit Agent with Beyond Presence Avatar

If you already have a functional LiveKit voice agent, skip to Step 5

Create a LiveKit API Key

In your LiveKit Cloud project, go to “Settings” > “API Keys”, generate a new LiveKit API key, and save the resulting code snippet.

Export Environment Variables

Set your Beyond Presence and LiveKit secrets as environment variables:

export BEY_API_KEY="..."  # Your Beyond Presence API key from Step 1.2
export BEY_AVATAR_ID="..."  # Your Beyond Presence Avatar ID from Step 1.3
export LIVEKIT_API_KEY="..."  # From LiveKit API key setup (Step 2.2)
export LIVEKIT_API_SECRET="..."  # From LiveKit API key setup (Step 2.2)
export LIVEKIT_URL="..."  # From LiveKit API key setup (Step 2.2)

Run LiveKit Agents Quickstart

Clone the LiveKit Agents Python Quickstart and follow the README to set up and run your first voice agent in a matter of minutes.

Install Beyond Presence LiveKit Plugin

Install the Beyond Presence LiveKit plugin livekit-plugins-bey:

pip install livekit-plugins-bey

Add Beyond Presence Avatar to Voice Agent

Edit src/agent.py and add the Beyond Presence avatar to your voice agent:

# session = AgentSession(...)

from livekit.plugins import bey

avatar = bey.AvatarSession(avatar_id=os.environ["BEY_AVATAR_ID"])
await avatar.start(session, room=ctx.room)

# await session.start(...)

Note that Beyond Presence supports several ways of technical integration, but if you are familiar with Python, we recommend using our LiveKit Agents plugin as shown in this guide.

Get Started

Core Concepts

Integrations

Production Guides

Learn More

Part 1: Set Up Beyond Presence

Create an API Key

Default Avatars

Part 2: Create a LiveKit Agent with Beyond Presence Avatar

Learn More

LiveKit Agents Integration

Create a Custom Avatar

​Part 1: Set Up Beyond Presence

Create an API Key

Default Avatars

​Part 2: Create a LiveKit Agent with Beyond Presence Avatar

​Learn More

LiveKit Agents Integration

Create a Custom Avatar

Part 1: Set Up Beyond Presence

Part 2: Create a LiveKit Agent with Beyond Presence Avatar

Learn More