Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.hyperfx.ai/llms.txt

Use this file to discover all available pages before exploring further.

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 key
For how integrations work overall (permissions, authentication, troubleshooting), see the main guide: App Integrations.

​
Connect HeyGen

  1. Go to Settings → Apps in Hyper
  2. Select HeyGen → Connect New
  3. Paste your HeyGen API key

​
Where to find your HeyGen API key

  1. Sign in to HeyGen
  2. Go to Settings → API
  3. Generate an API key with the scopes you need (avatar video, translation, lipsync)
  4. 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

  1. In a chat, open the tool selector and enable HeyGen
  2. Ask your agent to produce a video
Example prompt: 
Generate a 30-second HeyGen avatar video using my "Brand Spokesperson" avatar. Script: "Q4 was our best quarter ever — here's what happened and what's next." Use the "Marketing Voice" voice. Send the rendered video to the #marketing Slack channel when it's done.

​
Use in Agents

In Agents → 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