Skip to main content
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:

​
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

​
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: Configure these in the agent’s toolkit settings or in workspace defaults.