​
Overview

HeyGenVideoService integrates with HeyGen to create interactive AI-powered video avatars that respond naturally in real-time conversations. The service handles bidirectional audio/video streaming, avatar animations, voice activity detection, and conversation interruptions to deliver engaging conversational AI experiences with lifelike visual presence.

HeyGen Video API Reference

Pipecat’s API methods for HeyGen video integration

Example Implementation

Complete example with interactive avatar

HeyGen Documentation

Official HeyGen API documentation and guides

HeyGen Platform

Access interactive avatars and API keys

​
Installation

To use HeyGen services, install the required dependency: 
pip install "pipecat-ai[heygen]"

​
Prerequisites

​
HeyGen Account Setup

Before using HeyGen video services, you need:
  1. HeyGen Account: Sign up at HeyGen Platform
  2. API Key: Generate an API key from your account dashboard
  3. Avatar Selection: Choose from available interactive avatars
  4. Streaming Setup: Configure real-time avatar streaming capabilities

​
Required Environment Variables

  • HEYGEN_API_KEY: Your HeyGen API key for authentication