← Tools Reference

HeyGen

HeyGen integration (AI, Design & Media). Imported from open-connector.

API key14 toolshttps://upload.heygen.com
GET
heygen_get_current_user
Retrieve profile information for the HeyGen account associated with the API key.

/v1/user/me

GET
heygen_get_remaining_quota
Retrieve the remaining generation quota for the authenticated HeyGen account.

/v2/user/remaining_quota

GET
heygen_list_avatars
List HeyGen avatars and talking photos available for video generation.

/v2/avatars

GET
heygen_get_avatar
Retrieve details for a single HeyGen avatar by avatar ID.

/v2/avatar/{avatarId}/details

1 parameter
ParamTypeRequiredDescription
avatarIdstringrequiredThe unique HeyGen avatar ID to retrieve.
GET
heygen_list_voices
List HeyGen voices available for video narration.

/v2/voices

GET
heygen_list_templates
List HeyGen templates created under the authenticated account.

/v2/templates

GET
heygen_get_template
Retrieve variable definitions and metadata for a single HeyGen template.

/v3/template/{templateId}

1 parameter
ParamTypeRequiredDescription
templateIdstringrequiredThe unique HeyGen template ID to retrieve.
GET
heygen_get_video_status
Retrieve processing status and download URLs for a HeyGen video by video ID.

/v1/video_status.get

1 parameter
ParamTypeRequiredDescription
videoIdstringrequiredThe HeyGen video ID returned by a generation request.
POST
heygen_upload_asset
Upload an image, video, or audio file to HeyGen and return an asset ID usable in video generation.

/v1/asset

2 parameters
ParamTypeRequiredDescription
contentBase64stringrequiredThe media file content encoded as a Base64 string.
mimeTypestringrequiredThe MIME type of the media file to upload.
GET
heygen_list_assets
List uploaded HeyGen image, video, and audio assets so they can be reused in video generation.

/v1/asset/list

4 parameters
ParamTypeRequiredDescription
limitintegeroptionalThe maximum number of assets to return, from 0 to 100. Use 0 to request no asse…
tokenstringoptionalThe pagination token returned by a previous request.
fileTypestringoptionalThe asset type to list: image, video, or audio.
folderIdstringoptionalThe HeyGen folder ID to list assets from.
POST
heygen_delete_asset
Delete a HeyGen asset that is no longer needed.

/v1/asset/{assetId}/delete

1 parameter
ParamTypeRequiredDescription
assetIdstringrequiredThe HeyGen asset ID to delete.
GET
heygen_list_videos
List generated HeyGen videos for historical result management.

/v1/video.list

4 parameters
ParamTypeRequiredDescription
limitintegeroptionalThe maximum number of videos to return, from 0 to 100.
tokenstringoptionalThe pagination token returned by a previous request.
folderIdstringoptionalThe HeyGen folder ID to list videos from.
titlestringoptionalThe video title to search for.
DELETE
heygen_delete_video
Delete a generated or translated HeyGen video that is no longer needed.

/v1/video.delete

2 parameters
ParamTypeRequiredDescription
videoIdstringrequiredThe HeyGen video ID to delete.
typestringoptionalThe video category, either heygen_video or video_translate.
GET
heygen_list_folders
List HeyGen folders and folder IDs that can be used with HeyGen video generation inputs.

/v1/folders

5 parameters
ParamTypeRequiredDescription
limitintegeroptionalThe maximum number of folders to return, from 0 to 100.
parentIdstringoptionalThe parent folder ID to filter by.
nameFilterstringoptionalThe full or partial folder name to search for.
isTrashbooleanoptionalWhether to list folders in the trash.
tokenstringoptionalThe pagination token returned by a previous request.