What problem does it solve?
Heygen-cli removes the need for an unofficial or unmaintained HeyGen wrapper by letting operators generate and monitor avatar videos through HeyGen’s REST API in a controlled way.
Core Features & Use Cases
- Avatar & asset discovery (read-only): List HeyGen avatars, voices, templates, and fetch video status without spending money.
- Video generation (paid, confirmation required): Generate a new talking-head avatar video from an avatar/voice/script or from a saved template with variables.
- Operator safety guardrails: Hard-fail when HEYGEN_API_KEY is missing and validate inputs like allowed aspect ratios to reduce accidental spend and mis-specified requests.
Quick Start
Ask the AI to generate a HeyGen video by sourcing the skill library, selecting an avatar and voice from list endpoints, confirming the paid generation action, then polling until the video completes.