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:

  1. Passing your Synthesia API key in the header section
  2. Using the endpoint description to craft your request
  3. Click on Try it! 🚀

Rate limits

Synthesia APIs have the following rate limits:

EndpointRate limitis
Create video60 req/min ; 300/hour ; 1000/day
Update video60 req/min ; 300/hour ; 1000/day
Retrieve a video60req/min ; 40000 req/day
List videos60req/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.