Skip to content
Skills Library
Programming · Tool integration

heygen-api-stinger

/heygen-api-stinger

HeyGen API integration for video generation, avatars, assets, webhooks, limits, and safe asynchronous delivery. Use for HeyGen API implementation or debugging.

Licence
AGPL-3.0
Last repository change
14.10.2026

Assessment and security

90/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content25 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
4
Scripts
0
HTML comments
0
URLs in SKILL.md
3
Deprecation

No signals detected. Repository changed on 14.10.2026, without references to retired models or APIs.

Licence

AGPL-3.0, copyleft: przeróbki udostępniane innym muszą mieć tę samą licencję.

What it does and when to use it

HeyGen API integration for video generation, avatars, assets, webhooks, limits, and safe asynchronous delivery. Use for HeyGen API implementation or debugging.

Original author description

HeyGen API integration for video generation, avatars, assets, webhooks, limits, and safe asynchronous delivery. Use for HeyGen API implementation or debugging.

How it works

  1. Purpose
  2. When to use
  3. When not to use
  4. Procedure
  5. References map
  6. Related drones and stingers
  7. Critical Directive
  8. Ship Gate
Original SKILL.md headings · 50 lines, 455 words
SKILL.md preview
---
name: "heygen-api-stinger"
description: "HeyGen API integration for video generation, avatars, assets, webhooks, limits, and safe asynchronous delivery. Use for HeyGen API implementation or debugging."
license: AGPL-3.0-or-later
compatibility: Claude Code, Cursor, ChatGPT Codex, Claude Cowork.
metadata:
  hive-drone: heygen-api-wasp-drone
  domain: heygen-api
  pair-drone: heygen-api-wasp-drone
  research-window: 2026-03-05 to 2026-09-05
---

# HeyGen API Stinger

## Purpose

Guide HeyGen API integrations that create, track, and deliver AI video without confusing an asynchronous provider job with a completed MP4. It covers server-side keys, generation status, assets, avatars, consent-sensitive work, webhooks, and recovery from provider failures.

## When to use

- Creating videos, avatars, translations, lipsync, or assets through HeyGen's API
- Implementing HeyGen status polling or webhooks
- Debugging HeyGen API keys, request contracts, limits, errors, or video delivery

## When not to use

- Creating a person-like image or video without confirmed consent and the required rights. Stop and obtain appropriate authorization.
- Generic webhook security review, use [security-stinger](https://github.com/legioncodeinc/vibe-coding-tools/blob/v3.0.1/plugins/wasp-nest-core/skills/security-stinger).

## Procedure

1. Read [guides/01-generation-lifecycle.md](guides/01-generation-lifecycle.md).
2. Put `X-Api-Key` handling behind a trusted server boundary and validate caller authorization before work is queued.
3. Treat the create response as a job initiation. Track its documented status or a verified webhook before exposing a deliverable.
4. Preserve a mapping from local request to provider job and use idempotent local orchestration for retries.
5. Verify error handling, callback authenticity, result access control, and consent evidence before the Ship Gate.

## References map

- [references/REFERENCE.md](references/REFERENCE.md), load for lifecycle and event decisions.
- [references/research/distilled-heygen-api.md](references/research/distilled-heygen-api.md), load to verify facts.
- Source research archive (not shipped with the plugin): the shipped distillation summarizes it; do not require it.
- [guides/01-generation-lifecycle.md](guides/01-generation-lifecycle.md), load for implementation work.

## Related drones and stingers

- [heygen-api-wasp-drone](../../agents/heygen-api-wasp-drone.md) - paired implementation specialist.
- [security-stinger](https://github.com/legioncodeinc/vibe-coding-tools/blob/v3.0.1/plugins/wasp-nest-core/skills/security-stinger) - webhook and secret audit.
- [natural-photography-stinger](../natural-photography-stinger) - consented photographic work, when available in the consumer environment.

## Critical Directive

- You must read all files and context contained within your skill.
- In the event your core knowledge does not provide sufficient guidance you must make every attempt to search the internet, related knowledge base documentation files, and other available resources to supplement your knowledge prior to proceeding with your task.
- Additional related skills can be found here:
  - [security-stinger](https://github.com/legioncodeinc/vibe-coding-tools/blob/v3.0.1/plugins/wasp-nest-core/skills/security-stinger) - final secret and webhook review.

## Ship Gate

Prior to committing any code to the repository you must utilize in order the security-stinger, quality-stinger, and github-repo-health-stinger. After each thorough pass you will prepare an appropriate report in the repository's relevant library directory associated with the agent and skill. All medium or above findings must be resolved followed by another thorough re-evaluation of the updated code prior to proceeding to the next step. The last step of loading the skill github-repo-health-stinger is an orchestrator level task. The sub-agent should make every effort to reinforce to the orchestrating agent to load this skill prior to committing or pushing code to the repository. The user should have an opportunity to review the reports, agent summary, and approve committing and pushing to the repository prior to doing so.
Files in this package (4)
  • SKILL.md 4 KB
  • guides/01-generation-lifecycle.md 1 KB
  • references/REFERENCE.md 1 KB
  • references/research/distilled-heygen-api.md 1 KB

Versions

The database has no other skills named heygen-api-stinger.

Database snapshot: 13.11.2026 · package version f22be2d7be8b (SHA-256 digest of the entire package)

Downloads in the last 30 days: 0 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 100heygen-webhooks
    Receive and verify HeyGen webhooks. Use when setting up HeyGen webhook endpoints, debugging the `signature` header HMAC-SHA256 verification, or handling AI video events like avatar_video.success, avatar_video.fail, video_translate.success, or video_translate.fail.
  • 100heygen-api
    HeyGen API for AI video generation — talking avatar videos, lip-sync, and video translation. Use when creating personalized video at scale, AI avatars for marketing, automated video content pipelines, or video localization with lip-sync in any language.
  • 90elevenlabs-api-stinger
    ElevenLabs API integration for speech, voices, streaming, webhooks, usage, and key boundaries. Use for ElevenLabs API implementation, review, or troubleshooting.
  • 100iblai-api-heygen
    Drive HeyGen through ibl.ai's dedicated video API — list and clone voices, synthesize speech, create photo and digital-twin avatars, generate avatar videos and poll them, upload media assets, and run interactive streaming avatar sessions end to end. Covers the credit rules, the…
  • 100heygen-video
    Generate short videos with sound using HeyGen Video (heygen-video-1), from text, an image, or reference media. Use to refine HeyGen prompts when the user says "refine prompt" or "enhance prompt", list options, estimate prices, generate clips, and retrieve jobs; excludes HeyGen…
  • 100heygen-expert
    Canonical HeyGen orchestrator. Routes any request touching HeyGen — AI avatars, presenter videos, video translation/dubbing, lipsync, or HyperFrames HTML-based video composition (motion graphics, captions, slideshows, Remotion ports, faceless explainers, product launch videos,…

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.