heygen

Generate avatar-based videos and manage HeyGen video assets.

1|Updated Apr 11, 2026
One-click install
npx skills add https://github.com/shige1014-dev/backup-OpenMontage --skill heygen-shige1014-dev
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: heygen
Source: https://github.com/shige1014-dev/backup-OpenMontage/tree/main/.agents/skills/heygen
Command: npx skills add https://github.com/shige1014-dev/backup-OpenMontage --skill heygen-shige1014-dev

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Provide a unified, documented workflow for creating avatar-driven and prompt-based videos using the HeyGen API, reducing friction around authentication, asset uploads, status polling, and integration into composition pipelines. The skill consolidates guidance for both one-shot Video Agent prompts and the more precise v2 avatar/photo workflows so agents and engineers can produce publishable videos reliably. Note: this entry is deprecated in favor of more focused skills like create-video and avatar-video, but retains full reference material for backward compatibility.

Core Features & Use Cases

  • Automated video generation via HeyGen Video Agent or v2 video generation for multi-scene control.
  • Asset upload and management for backgrounds, talking photos, and audio; photo-avatar (Avatar IV) workflows and template-based batch generation.
  • Status polling, quota checks, webhooks, and Remotion integration for composing or rendering final video outputs.
  • Use Case: programmatically generate a 90s product demo using an avatar, upload a branded background, poll until completion, download the MP4, and incorporate it into a Remotion composition.

Quick Start

Generate a 60-second avatar video using an optimized prompt, ensure HEYGEN_API_KEY is set in your environment, and poll the returned video_id for completion to retrieve the final video URL.

Frequently Asked Questions about heygen

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I generate AI avatar videos using the HeyGen API?

To generate AI avatar videos, use the HeyGen v2 video generation endpoints or Video Agent prompts. Configure your HEYGEN_API_KEY, submit the generation request, and poll the returned video_id for completion to retrieve the final video URL.

Can I use HeyGen talking photos and custom backgrounds for video generation?

Yes, HeyGen video generation supports talking photos and custom backgrounds. You can upload and manage these assets programmatically using the asset upload endpoints before referencing them in your avatar or template-based video generation workflows.

How do I check my HeyGen API quota and video generation status?

You can check HeyGen API quota and video generation status by polling the dedicated status endpoints. The skill also supports webhooks, allowing you to receive asynchronous notifications when a video generation job completes instead of manual polling.

Does HeyGen video generation work with Remotion composition pipelines?

Yes, HeyGen video generation integrates with Remotion composition pipelines. You can generate an avatar video, poll until completion, download the MP4 file, and incorporate that asset directly into a Remotion composition for final rendering.

What is the difference between HeyGen Video Agent prompts and v2 avatar workflows?

HeyGen Video Agent prompts offer one-shot generation for quick results, while v2 avatar and talking-photo workflows provide multi-scene control for precise video generation. The skill consolidates guidance for both approaches to produce publishable videos reliably.

Do I need an API key to use HeyGen for programmatic video generation?

Yes, you must set the HEYGEN_API_KEY in your environment to authenticate requests for programmatic video generation, asset uploads, quota checks, and webhook configuration using the HeyGen v1 and v2 HTTP endpoints.