heygen-cli

Generate HeyGen avatar videos via REST API with jq and curl.

6|1|Updated May 13, 2026
One-click install
npx skills add https://github.com/Xipher-Labs/walter-os --skill heygen-cli
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: heygen-cli
Source: https://github.com/Xipher-Labs/walter-os/tree/main/skills/heygen-cli
Command: npx skills add https://github.com/Xipher-Labs/walter-os --skill heygen-cli

SYSTEM DOCUMENTATION & REQUIREMENTS

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.

Frequently Asked Questions about heygen-cli

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

FAQPage Schema
How do I generate HeyGen avatar videos from the terminal?

You can generate HeyGen avatar videos from a terminal by calling the HeyGen REST API to start generation jobs and polling their status until completion, requiring explicit operator confirmation before executing paid video creation.

Do I need an API key to list HeyGen avatars and voices?

Yes, listing HeyGen avatars and voices requires a HEYGEN_API_KEY environment variable, as the CLI hard-fails when missing to ensure authenticated read-only API discovery calls without accidental spend.

Can I check HeyGen video status without spending money?

Yes, you can check HeyGen video status without spending money because the workflow strictly separates read-only discovery calls from state-changing paid video generation actions that require explicit operator confirmation.

How do I prevent accidental paid spend when automating HeyGen video generation?

You prevent accidental paid spend during HeyGen video generation through operator safety guardrails that validate inputs like aspect ratios and require explicit confirmation before executing state-changing paid API calls.

What dependencies are required to run HeyGen REST API calls from a terminal?

Running HeyGen REST API calls from a terminal requires curl and jq installed alongside a valid HEYGEN_API_KEY to execute requests, parse JSON responses, and poll video generation job status.