Synthesia STUDIO lets you create one-off videos and test different types of videos before automating the process through the API. Also, Synthesia STUDIO lets you define API templates with personalization variables that you can call later through the API.
You need to have a paid account to Synthesia STUDIO to start using our API. You can create free videos in the test mode of our API.
Synthesia API uses API keys as an authentication mechanism. You will find your API key in Synthesia STUDIO account settings. If you cannot find your API key, please follow the Get Started with Synthesia API guide.
The API key should be passed as a header value on each request.
Test Synthesia APIs from this documentation
Test Synthesia API directly from this documentation by:
- Passing your Synthesia API key in the header section
- Using the endpoint description to craft your request
- Click on
Try it!🚀
Rate limits
Synthesia APIs have the following rate limits:
| Endpoint | Rate limitis |
|---|---|
| Create video | 60 req/min ; 300/hour ; 1000/day |
| Update video | 60 req/min ; 300/hour ; 1000/day |
| Retrieve a video | 60req/min ; 40000 req/day |
| List videos | 60req/min ; 40000 req/day |
If you go above the limits, Synthesia API responds with a status: 429 Too Many Requests with the following header parameters:
-
RateLimit-Limit: Telling you which limit has been breached, for example, "60" for 60 requests per minute limit -
RateLimit-Reset: Telling you how many seconds you mus to wait before the next request.