> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bey.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Speech-to-Video Quickstart

> Start building with Beyond Presence Speech-to-Video API and LiveKit Agents.

<Check>
  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](/get-started/quickstart/managed-agent) instead.
</Check>

## Part 1: Setup Beyond Presence

<Steps>
  <Step title="Sign Up to Beyond Presence">
    Go to the [Beyond Presence Studio](https://bey.studio) and sign up with either your email or your Google account.
  </Step>

  <Step title="Create an API Key">
    Go to the [API Keys tab](https://bey.studio/settings/api-keys) in your account settings, create a new API key, and
    save it somewhere.

    <Card title="Create an API Key" icon="key" href="/concepts/api#authentication">
      Learn more about how to use API keys for using the Beyond Presence API.
    </Card>
  </Step>

  <Step title="Select an Avatar">
    Go to the [Avatars tab](https://bey.studio/avatars) 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.

    <Card title="Default Avatars" icon="link" href="/concepts/avatars/stock">
      Explore our stock avatars that can be used immediately.
    </Card>
  </Step>
</Steps>

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

<Tip>If you already have a functional LiveKit voice agent, skip to **Step 5**</Tip>

<Steps>
  <Step title="Sign Up to LiveKit Cloud">
    Sign up to LiveKit at [https://cloud.livekit.io/](https://cloud.livekit.io/) and create a new project.
  </Step>

  <Step title="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.
  </Step>

  <Step title="Export Environment Variables">
    Set your Beyond Presence and LiveKit secrets as environment variables:

    ```bash theme={null}
    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)
    ```
  </Step>

  <Step title="Run LiveKit Agents Quickstart">
    Clone the [LiveKit Agents Python Quickstart](https://github.com/livekit-examples/agent-starter-python/tree/7c0af539fe065e262f31942715f5f97e1579fd78)
    and follow the README to set up and run your first voice agent in a matter of minutes.
  </Step>

  <Step title="Install Beyond Presence LiveKit Plugin">
    Install the Beyond Presence LiveKit plugin `livekit-plugins-bey`:

    ```bash theme={null}
    pip install livekit-plugins-bey
    ```
  </Step>

  <Step title="Add Beyond Presence Avatar to Voice Agent">
    Edit `src/agent.py` and add the Beyond Presence avatar to your voice agent:

    ```python theme={null}
    # 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(...)
    ```
  </Step>
</Steps>

## More Info

Note that Beyond Presence supports [several ways of technical integration](/integrations),
but if you are familiar with Python, we recommend to use our [LiveKit Agents Integration](/integrations/voice-agents/livekit):

<Card title="LiveKit Agents Integration" icon="puzzle-piece" href="/integrations/voice-agents/livekit">
  Learn more about how the Beyond Presence's LiveKit Agents plugin works.
</Card>

## Next Steps

<CardGroup cols={2}>
  <Card title="Create a Custom Avatar" icon="face-smile-wink" href="/concepts/avatars/custom">
    Learn how to create your own Beyond Presence avatar.
  </Card>

  <Card title="Other Integrations" icon="route" href="/get-started/choose-path">
    Learn about our other integration options and find the right path for you.
  </Card>
</CardGroup>