API Plan Tiers

Below are the of tiers of API usage available:

API Plan Tier	API Credits	Price
Free Trial	10 / month	Free
Pro	100 / month	$99 / month
Scale	660 / month	$330 / month, with auto-renew option
Enterprise	Custom	Contact enterprise@heygen.com

🧪 All users — including on the Free plan — receive 10 API credits per month to test the APIs.

Please note that the video_translate and proofread endpoints can only be used by Scale Plan and Enterprise Plan customers.

What is an API Credit?

API Credits are used when performing various tasks like creating videos, translating content, or using Interactive Avatars. The credit usage depends on the endpoint:

Functionality	Credit Cost	Details
`/video/generate` (Photo Avatar)	1 credit / min	Charged in 30 sec increments
`/video/generate` (Video Avatar)	2 credits / min	Charged in 30 sec increments
`/video_translate`	3 credits / min (`fast`mode) 6 credits / min (`quality`mode)	Charged in 30 sec increments
`/video_translate/proofread`	1 credit / 2 min	2-min video = 1 credit
`/v2/video/av4/generate`	6 credits / min
Active streaming session	0.2 credits / min	30 sec min, 1 sec increments after
`photo_avatar/photo/generate`	1 credit per call
`photo_avatar/look/generate`	1 credit per call
`photo_avatar/train`	4 credits per call
`photo_avatar/add_motion`	1 credit per call
`photo_avatar/add_sound_effect`	Free
`photo_avatar/upscale`	0.5 credits per call

Check your usage histoy at: Space Settings → History → API Usage

Video Generation Concurrent Job Limits

The amount of videos that can be simultaneously processed. Other videos will sit in a queue until currently still processing videos are completed.

API Plan Tier	Number of concurrent video generations
Free	1
Pro	3
Scale	6
Enterprise	Custom

Video Length and Resolution Limits

The length of videos that can be translated or generated via API is limited by Tier:

API Plan Tier	Video Length	Video Resolution Limit
Free	3 minutes	720p
Pro	5 minutes	1080p
Scale	30 Minutes	4k
Enterprise	Custom	4k

Photo Avatar and Look Generation Limits

Photo Generation (API vs Web)

You can generate unlimited photos using the API.
However, the HeyGen Web App has a limit of 400 photo generations per month.
If you exceed 400 total photos (including those created via API), the Web App will block further photo generation until the next month.
You can still continue generating photos via API, even after reaching the web limit.

Avatar Looks per Group

Max 500 Looks per Avatar Group.

Avatar Group Generation

Plan	Max Avatar Groups
Free	3
Pro	10
Scale	Unlimited
Enterprise	Unlimited

`video/generate` Endpoint Limits

Resources

HeyGen limits the size and format of resources such as images, audio or video, that can be uploaded to the Video/Generate endpoint. Render errors may occur if resources are invalid.

Resource Type	Supported format	Max File Size	Resolution
Video	MP4	100MB	<2K
Image	JPG, PNG	50MB	<2K
Audio	WAV, MP3	50MB

Please ensure:

Your resource URL is public and accessible to anyone.
The provided asset is in one of the supported formats.
Check that the asset file extension aligns with the actual format.
Verify that the asset file is not corrupted or misformatted.

Video Avatar Input

Avatar input can be either text or audio:

The Input Text - which is the text the Avatar speaks - should be less than 5,000 characters.
The duration of audio input for avatars should not exceed 10 minutes (3600 seconds).

Invalid inputs will result in video render failures.

Output Video Specifications

The frame rate of video output containing avatars is 25fps.
dimension parameter width or height must be less than 4096 and greater than 128.
Maximum 50 Video Input/scenes allowed per video.
WebM Format: Available only to paid API plans.

Streaming API endpoint

Repeat Task

Up to 1,000 characters at a time can be sent to the Interactive Avatar to repeat text.