Built by Metorial, the integration platform for agentic AI.
Upload an asset (image, video, or audio) to HeyGen from a public URL. The uploaded asset can be used as a background, audio input, or visual element in video generation.
List generated videos in your HeyGen account with pagination support. Returns video IDs, statuses, titles, and URLs.
Retrieve all available AI avatars in your HeyGen account, including both public and custom avatars. Returns avatar IDs needed for video generation, along with preview images and videos.
Generate natural-sounding speech audio from text using HeyGen's text-to-speech engine. Returns an audio URL suitable for narration, podcasts, IVR prompts, or use as audio input in video generation.
List uploaded assets (images, videos, audio files) in your HeyGen account. Assets can be used as backgrounds, custom audio inputs, or visual elements in video generation.
Generate a video using the Video Agent from a simple natural language prompt. Instead of manually configuring scenes, avatars, and scripts, describe what you want and HeyGen's AI handles the rest — from scriptwriting to visual assembly.
Translate a video into one or more target languages with natural voice cloning and lip-sync. Submit a video by URL or HeyGen video ID. Translation is asynchronous — use "Get Translation Status" to check progress.
Retrieve all available voices for text-to-speech in HeyGen. Returns voice IDs needed for video generation and TTS, along with language, gender, and preview audio. Includes both HeyGen and ElevenLabs voices.
Retrieve all talking photos (photo avatars) in your HeyGen account. Talking photos are still images that can be animated to speak text. Their IDs can be used with character type "talking_photo" when creating avatar videos.
Check remaining API credits and account quota. API usage is measured in credits — as a general rule, 1 credit = 1 minute of generated avatar video.
List all available video templates in your HeyGen account. Returns template IDs and names. Use "Get Template" to see the dynamic variables for a specific template.
Create a session token for Interactive Avatar streaming. The token is used to establish a real-time streaming session where an avatar can respond to user input. Required before starting a streaming session in your application.
Retrieve details of a specific template including its dynamic variable definitions. Use this to understand what variables need to be provided when generating a video from a template.
Check the status of a video generation job and retrieve the completed video URL. Use this after creating a video to poll for completion. Returns the video URL, thumbnail, GIF preview, and duration once complete.
Permanently delete a generated video from your HeyGen account.
Generate an AI avatar video with one or more scenes. Each scene has an avatar character, voice/script, and optional background. Supports multi-scene videos with different avatars, voices, and backgrounds per scene. Video generation is asynchronous — use **Get Video Status** to check when it's ready.
Permanently delete an uploaded asset from your HeyGen account.
Generate a customized video from a HeyGen template by filling in dynamic variables. Templates are pre-designed in HeyGen's web interface and contain placeholders (e.g. `{{name}}`, `{{company}}`) that you populate via the API. Ideal for personalized videos at scale.
Check the status of a video translation job and retrieve translated video URLs. Returns per-language translation status and video URLs once complete.