The HeyGen integration lets your agents generate AI avatar videos, run text-to-speech with cloned voices, translate videos into other languages, and produce lipsync videos. Auth type: API keyDocumentation Index
Fetch the complete documentation index at: https://hyperfx.ai/docs/llms.txt
Use this file to discover all available pages before exploring further.
For how integrations work overall (permissions, authentication, troubleshooting), see the main guide: App Integrations.
Connect HeyGen
- Go to Settings → Apps in Hyper
- Select HeyGen → Connect New
- Paste your HeyGen API key
Where to find your HeyGen API key
- Sign in to HeyGen
- Go to Settings → API
- Generate an API key with the scopes you need (avatar video, translation, lipsync)
- Copy the key and paste it into Hyper
Common capabilities
- Avatar videos — list avatars and avatar groups, look up specific looks, create avatar videos from a script
- Voices and TTS — list voices, generate audio from text
- Video translation — translate an existing video into another language with the speaker’s voice
- Lipsync — sync a face to new audio
- Asset management — upload assets, list/get/delete videos
- Polling helpers — async-aware tools that wait for renders to complete
Use in Chat
- In a chat, open the tool selector and enable HeyGen
- Ask your agent to produce a video
Use in Agents
InAgents → Settings, add HeyGen to a content-production agent alongside Google Veo, OpenAI Sora, or image generation. Common pattern: an agent drafts the script → generates the avatar video → posts to social.
Use in Flows
Add HeyGen nodes to automated content pipelines. Common pattern: scheduled trigger → write script via LLM → render avatar video → publish to TikTok / Instagram Reels.Troubleshooting
- Render timed out: video translation and large avatar renders can take several minutes — use polling to wait gracefully
- Avatar not found: list avatars first to confirm the avatar ID belongs to your account
- Quota exceeded: HeyGen enforces credits per plan — upgrade or wait for the next billing cycle
Available Actions
Hyper agents can run the following actions for this integration. Each action can be individually set to Enabled, Requires Approval, or Disabled in your agent’s toolkit settings. Actions can be set to one of three control states:| State | Behavior |
|---|---|
| Enabled | Agent runs the action automatically |
| Requires Approval | Agent pauses and waits for your confirmation before proceeding |
| Disabled | Action is blocked and cannot be used |
| Action | Description |
|---|---|
| Create Avatar Video | |
| Create Lipsync | |
| Create Video Translation | |
| Delete Lipsync | Delete a lipsync job by id (V3) |
| Delete Video | Delete a video by video_id (V2) |
| Get Avatar Group | Get a single HeyGen avatar group by group_id (V3) |
| Get Lipsync | Get a lipsync job by id (V3 /v3/lipsyncs/) |
| Get User Me | Return the authenticated HeyGen user account info (plan, remaining credits, etc.) |
| Get Video | Get details for a single video by video_id (V2) |
| Get Video Translation | Get a video translation job by id (V3 /v3/video-translations/) |
| List Audio Voices | List HeyGen audio (text-to-speech) voices via V1 endpoint |
| List Avatar Looks | List avatar looks across groups (V3). Optional query for filtering |
| List Avatars | List HeyGen avatar groups (V3). Optional query for pagination/filtering |
| List Lipsyncs | List lipsync jobs (V3). Optional query for pagination/filtering |
| List Translation Languages | List supported video translation languages (V3) |
| List Video Translations | List video translation jobs (V3). Optional query for pagination/filtering |
| List Videos | List videos for the account (V2 /v2/videos). Optional query for pagination |
| List Voices | List HeyGen voices (V3). Optional query params (page_size, language, gender, voice_id, etc.) may be passed via query |
| Poll Lipsync | |
| Poll Video | |
| Poll Video Translation | |
| Text To Speech | |
| Upload Asset |