heygen

Prepare guarded HeyGen API calls for avatar video generation and translation.

126|11|Updated Feb 24, 2026
One-click install
npx skills add https://github.com/HybridAIOne/hybridclaw --skill heygen-hybridaione
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: heygen
Source: https://github.com/HybridAIOne/hybridclaw/tree/main/skills/heygen
Command: npx skills add https://github.com/HybridAIOne/hybridclaw --skill heygen-hybridaione

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It removes the guesswork and risk of uncontrolled HeyGen API usage by turning avatar discovery, gated generation, translation, and status polling into a secure, operator-approved workflow for teams.

Core Features & Use Cases

  • Guarded Direct API Adapter: Prepares gateway-proxied requests for avatar video generation (POST /v2/videos) and translation (POST /v2/video_translate) while enforcing credit-consuming operator grants.
  • Discovery and Caching: Lists avatars, voices, and translation target languages, and produces compact asset summaries to validate ids before generating.
  • Reliable Async Tracking: Polls generation/translation status endpoints with bounded polling that respects retry-after behavior and detects terminal states.

Quick Start

Store your HeyGen API key as HEYGEN_API_KEY in HybridClaw secrets, then ask for an approval-aware translation workflow: "Translate this video into German using HeyGen, and wait for completion."

Frequently Asked Questions about heygen

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

FAQPage Schema
How do I generate HeyGen avatar videos with operator approval guardrails?

Generating HeyGen avatar videos with operator approval involves preparing gateway-proxied POST /v2/videos requests that enforce credit-consuming operator grants. The workflow validates avatar and voice asset ids against cached summaries before executing the generation call.

What is the best way to poll HeyGen API video translation status asynchronously?

Polling HeyGen API video translation status requires bounded polling of status endpoints that respects retry-after headers. This mechanism detects terminal states and classifies transient upstream responses for reliable async tracking without exceeding rate limits.

How do I securely inject a HeyGen API key without exposing it?

Securely injecting a HeyGen API key involves passing the HEYGEN_API_KEY through gateway secret headers. This approach proxies requests without exposing the key directly, ensuring secure authentication for avatar video generation and translation workflows.

Why does my HeyGen API integration fail on private media URLs?

HeyGen API integrations fail on private media URLs because the workflow explicitly blocks private and internal media URLs. This guardrail prevents unauthorized asset access and ensures only publicly accessible media is processed for video generation and translation.

Can I list and validate HeyGen voices and avatars before submitting a video request?

You can list and validate HeyGen voices and avatars before submitting a video request by using the discovery feature. It lists available assets and translation target languages, then produces compact asset summaries to validate ids prior to generation.