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

# HeyGen Photo Avatar

> Create custom HeyGen Photo Avatars from uploaded or AI-generated images.

## Overview

The HeyGen Photo Avatar pack creates reusable avatars that can later drive talking videos via HeyGen. You can either **upload** reference photos (base64) or **generate** a new avatar via AI using age/gender/ethnicity/style parameters.

**Use cases**

* Building a custom avatar library per customer / brand
* On-the-fly avatar generation for personalized videos
* Pair with [HeyGen Avatar](/agent-packs/heygen-avatar) for end-to-end video generation

***

## Pack actions

| Stage       | Action                                     | Purpose                                                                                 |
| ----------- | ------------------------------------------ | --------------------------------------------------------------------------------------- |
| PA1         | `heygen_photo_avatar_create_avatar_action` | Create a Photo Avatar from uploaded photos or generated parameters. Returns `group_id`. |
| PA1\_Report | `heygen_photo_avatar_render_avatar_report` | Render avatar creation status as an HTML report.                                        |

## Modes

* **Upload mode** — provide base64-encoded reference photos.
* **Generate mode** — pass age, gender, ethnicity, style parameters.

## Related

* [HeyGen Avatar](/agent-packs/heygen-avatar) to drive the avatar into a talking video.
* Full endpoint details in the [API Reference](/api-reference).