Rate Limits
The rate limits for HeyGen's API vary based on the token type, test mode, and endpoint:
Non-Streaming API Endpoints
- Trial Token: Allows up to daily limit videos per day, maximum video length 60 seconds, with a watermark.
- API Token
test modefor non-Streaming endpoints: Allows up to 60 videos per week/10 per day, maximum video length 60 seconds, with a watermark. - API Token
non-test modefor non-Streaming endpoints: Video generations are not rate-limited, no watermark, and are deducted from your credit.
The daily limit is 5 for Free Plan users, 8 for Creator Plan users, 10 for Team users, and 20 for Enterprise Plan users.
Limit periods are measured from the time of the first request made, e.g. with daily limits lasting 24 hours from the initial request.
To ensure a smooth interaction with the server and avoid potential throttling, it is recommended to space out your requests.
Streaming Endpoint
- Trial Token: Allows up to 3 concurrent sessions to be created, with no charge for usage.
- API Token : Allows up to 100 concurrent sessions to be created, each minute of the Interactive Avatar speaking consuming 1 API credit.
Basic API vs. Advanced API
| Category | Basic API | Advanced API |
|---|---|---|
| Eligibility | Automatically included in every enterprise plan. | Contact sales for access and customized options. |
| Concurrency | Limited Concurrency: Process up to 1 video at a time. | Customized Concurrency: Simultaneously process up to 10,000 videos. |
| API Specifications | - Create videos using pre-created instant, photo, or public avatars. - Localize videos with the video translation API. | Includes all Basic API features, plus: - Avatar creation capabilities. - Video translation proofreading and SRT upload API. - Customized API solutions tailored to your needs. |
- Avatar creation is not included due to safety controls. Use the HeyGen web interface to create avatars.
- SRT upload and proofreading services are not available.
- Trial API Keys available for all users, including free users, to generate avatar videos with a HeyGen watermark. Daily limits: 5 for free users, 8 for creators, 10 for teams, and 20 for enterprise users.
Resource Limits
HeyGen limits the size and format of resources such as images, audio or video. Render errors may occur if resources are invalid.
| Resource Type | Suportted 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.
Avatar Input Limits
Avatar input can be either text or audio:
- Text input for avatars should be less than 1500 characters.
- The duration of audio input for avatars should not exceed 10 minutes (3600 seconds).
Invalid inputs will result in video render failures.
Video Limits
- The frame rate of video output containing avatars is 25fps.
dimensionparameter width or height must be less than4096and greater than128.
Specific APIs
Create Video API:
- Maximum 10 VideoInput/scenes allowed per video.
Streaming Avatar API:
- 1000 character for repeat text.
Pricing
Price/credit usage is the same as our web interface. More details can be found here.