> ## 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 Avatar

> Generate talking-photo avatar videos from a blog URL, topic, or custom script.

## Overview

The HeyGen Avatar pack turns written content into a talking-avatar video. Point it at a blog URL (it will scrape and summarize) or pass a topic/script directly, and it submits the job to the HeyGen V2 API. The pack returns a `video_id` you can poll for status and the final `video_url` + `thumbnail_url` when rendering completes.

**Use cases**

* Auto-generated social video recaps for every new blog post
* Personalized sales video intros
* Turning newsletter copy into a distributable video format

***

## Pack actions

| Stage | Action                           | Purpose                                                                                                               |
| ----- | -------------------------------- | --------------------------------------------------------------------------------------------------------------------- |
| HG1   | `heygen_avatar_generate_video`   | Submit a video job (from URL, topic, or script). Returns `video_id`.                                                  |
| HG2   | `heygen_avatar_get_video_status` | Poll status (`pending` / `processing` / `completed` / `failed`). Returns `video_url` + `thumbnail_url` when complete. |

## Typical flow

```mermaid theme={null}
graph LR
  A[Blog URL / Topic / Script] --> B[HG1 Generate Video]
  B --> C[HG2 Get Status<br/>loop]
  C --> D[Video URL ready]
```

## Tips

* Wrap `heygen_avatar_get_video_status` in a [For Loop](/actions/for_loop) until `status == "completed"`.
* Pair with [Post to Bluesky](/actions/post_to_bluesky) or [Send Message](/actions/send_message) to distribute the final video.

## Related

* [HeyGen Photo Avatar](/agent-packs/heygen-photo-avatar) — create the avatar itself.
* [Instant Headshot](/agent-packs/instant-headshot) — for static professional headshots.
* Full endpoint details in the [API Reference](/api-reference).