Realtime Avatar API


The V2 Realtime Avatar API documentation and the github demo repo are private for a while due to some reasons.

HeyGen's Realtime Avatar API allows developers to seamlessly integrate dynamic digital avatars into their applications for immersive and interactive user experiences. With this API, you can create virtual assistants, real-time training simulations, and more with a focus on real-time, low-latency communication between users and avatars with power of WebRTC.

Quick Start

For a quick start, you can use our Realtime Avatar Streaming Demo GitHub repo.

  1. Clone the repository to your local machine:
git clone
  1. Open the index.js file put your api key and change your parameters. You can also set other parameters from the web interface.

  2. Open a terminal in the project folder and install the necessary dependencies and start the server:

npm install
node server.js

Open your web browser and navigate to localhost:3000 and there it is, our demo is working. You can read the Using the Demo section for further information.

Quick Guide

Use RealTime Avatar in 8 Steps! For a more detailed Realtime API demonstration, you can take a look at this guide we have prepared for you:

Streaming Protocol

The Realtime Avatar API leverages the WebRTC (Web Real-Time Communication) protocol to ensure low-latency, secure communication between browsers and applications. This foundational technology offers advantages including low latency, cross-browser compatibility, data security, and scalability. For detailed information on WebRTC, visit the WebRTC website or WebRTC API page on MDN.

Use Cases

From interactive e-learning and gaming to virtual customer support and immersive entertainment, real-time avatars have the potential to transform industries. Here are some of the use cases of Real-Time Avatars:

  • πŸ€– Virtual Assistants: Implement lifelike avatars integrate GPT models to enable dynamic and interactive conversations with AI-powered chatbots or virtual assistants to enhance user interactions and make them more engaging.
  • πŸŽ“ Interactive E-Learning: Create interactive and engaging e-learning modules with avatars as instructors or guides.
  • πŸ‘©β€πŸ’» Video Conferencing: Integrate avatars into video conferencing applications for more engaging and immersive online meetings.
  • πŸͺ© Virtual Events: Enrich virtual events, such as webinars or conferences, by using avatars as hosts or speakers.
  • πŸ“ž Customer Support: Improve customer support experiences by offering real-time assistance with avatars.
  • πŸ›οΈ Live Shopping: Develop captivating live stream shopping experiences where customers can interact with avatars or chatbots, obtain product recommendations, and make purchases instantly.
  • πŸ§‘β€πŸ”§ Training Simulations: Develop training simulations for various industries.
  • πŸ’« Entertainment: Create interactive entertainment experiences, like live shows or performances, using avatars.
  • πŸ—£οΈ Language Learning: Create interactive language learning platforms that enable users to practice speaking with virtual language tutors or engage in role-playing conversations, fostering effective language acquisition.

If you have innovative ideas and require technical support, feel free to reach out to us. We are here to assist you. Additionally, the possibilities for exploration are limitless!


In summary, the Realtime Avatar API empowers developers to create dynamic and interactive experiences by streaming avatar videos in real time. Whether you're building virtual assistants, customer support, or immersive training simulations, these APIs offer the tools needed to bring avatars to life within your applications, marking a significant advancement in user engagement and interactivity.