Connect HeyGen to Your AI Agent

Choose an avatar or template and provide the script or replacement content for the video you want.

17 tools API key

Try a HeyGen Task

Copy a prompt into your agent with the oo Skill installed. Add your page links and source notes before running it.

oo Skill HeyGen

Create a template video

Read template variables and generate a video using your supplied replacements.

/oo HeyGen: Read HeyGen template [ID]. Generate a video using these replacements [values], titled [title], without enabling immediate public sharing. Check status until complete and provide its video URL.

Start Working with HeyGen

  1. Install OOMOL

    Set up oo CLI and the oo Skill in your agent.

    Install OOMOL →
  2. Connect HeyGen

    Connect a HeyGen API key from your account’s API settings.

    Connect HeyGen →
  3. Give Your Agent a Task

    Use /oo with the pages to read, the changes to make, and where to save the result.

    Connection Guide →

Choose Your Agent

  • A HeyGen API key with generation access and sufficient quota.

HeyGen Tools

HeyGen operations discover avatars, voices, templates, and assets, submit asynchronous video generation, and retrieve video status and URLs.

Video resources

Discover avatars, narration voices, templates and uploaded media assets.

Generation and results

Generate avatar or template videos, check processing, and retrieve completed video and sharing links.

17 tools

Get Current User

Retrieve profile information for the HeyGen account associated with the API key.

heygen.get_current_user

Get Remaining Quota

Retrieve the remaining generation quota for the authenticated HeyGen account.

heygen.get_remaining_quota

List Avatars

List HeyGen avatars and talking photos available for video generation.

heygen.list_avatars

Get Avatar

Retrieve details for a single HeyGen avatar by avatar ID.

heygen.get_avatar

List Voices

List HeyGen voices available for video narration.

heygen.list_voices

List Templates

List HeyGen templates created under the authenticated account.

heygen.list_templates

Get Template

Retrieve variable definitions and metadata for a single HeyGen template.

heygen.get_template

Generate Video

Start an asynchronous HeyGen avatar video generation job and return the generated video ID.

heygen.generate_video

Generate Template Video

Start an asynchronous HeyGen template video generation job with explicit template variables.

heygen.generate_template_video

Get Video Status

Retrieve processing status and download URLs for a HeyGen video by video ID.

heygen.get_video_status

Get Shareable Video Url

Retrieve a public share URL for a rendered HeyGen video by video ID.

heygen.get_shareable_video_url

Upload Asset

Upload an image, video, or audio file to HeyGen and return an asset ID usable in video generation.

heygen.upload_asset

List Assets

List uploaded HeyGen image, video, and audio assets so they can be reused in video generation.

heygen.list_assets

Delete Asset

Delete a HeyGen asset that is no longer needed.

heygen.delete_asset

List Videos

List generated HeyGen videos for historical result management.

heygen.list_videos

Delete Video

Delete a generated or translated HeyGen video that is no longer needed.

heygen.delete_video

List Folders

List HeyGen folders and folder IDs that can be used with HeyGen video generation inputs.

heygen.list_folders

Frequently Asked Questions

How do I choose template replacement fields?

Read the template details and use the exact variable names it defines.

Does a video ID mean rendering has finished?

No. Generation returns an ID; check video status until a completed result and video URL are available.

Can I upload my own media?

Yes. Asset upload accepts base64 image, video, or audio content with its media type and produces a reusable asset ID.

Connect HeyGen

About HeyGen ↗