Synthesia Private Beta API

Welcome to the Synthesia developer hub. You'll find comprehensive guides and documentation to help you start working with Synthesia as quickly as possible, as well as support if you get stuck. Let's jump right in!

Get Started    

Synthesia API - Quick Start Guide

Get started with Synthesia API today and create the first video in just a few steps.

πŸ‘

Are you a developer or a non-developer?

Not a developer? You can use our API without writing a single line of code. Use our Zapier app and connect to 3000+ other applications. Get started with Zapier now

Developer? Read our quick guide below to get started in 10 minutesπŸ‘‡

1. πŸ†• Prerequisite: Get a paid Synthesia STUDIO account

Create Synthesia STUDIO account

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. When you're ready with your concept you can purchase Synthesia API packages here.

πŸ“˜

Pricing for Synthesia API Beta

Please head here to see and purchase Synthesia API packages.


2. πŸ—οΈ Create an API key

Create your API key

Once you’ve become a Synthesia STUDIO user, head to accounts settings, scroll down to "API Keys" area, and create a new API key.


3. 🎬 Create the first video

See Detailed API Reference

We will create the first video in β€œtest” mode. Test videos are free and not counted towards your quota. If you create video in β€œtest” mode, we will override your background with Synthesia branded background.

curl https://api.synthesia.io/v1/videos  \
  -H "Authorization: ${API_KEY}" \
  -H "Content-Type: application/json" \
  -X POST \
  -d '{ "test": true, "input": [{ "script": "Hello, World! This is my first synthetic video, made with the Synthesia API!", "actor": "anna_costume1_cameraA", "background": "green_screen"}] }'

We will send you a response {...} where you can find an ID of the newly created video.

Create videos via templates: alternatively, you can create videos via templates as well. Read more about how to use templates here.


4. πŸ“½οΈ Wait for your video

See Detailed API Reference

As soon as you create a video, we begin processing it. This can take from 3-10 minutes. When the video is ready for playback, the video status changes to COMPLETE.

You can poll the API to see the video status with the following call:

curl https://api.synthesia.io/v1/videos/${VIDEO_ID} \
  -H "Authorization: ${API_KEY}" \
  -X GET

Webhooks: rather than polling, it is possible to configure a webhook to which we will send a notification when a video completes successfully. For more information, refer to the webhook documentation.


5. πŸ“‚ Download the video

Once your video is ready, the response will include a time-limited β€œdownload link”.

See example video object response here.

You can use the link to download the video as .mp4.

curl ${DOWNLOAD_URL} --output my_first_synthetic_video.mp4

6. πŸ“œ Explore our detailed API documentation

You can see our detailed API reference with all current possible calls and parameters here.


7. πŸ’¬ Join our user group

Join our Slack group to get updates on what's new, discuss API use cases with other users and more. You can join our group here.

Updated 7 days ago


Synthesia API - Quick Start Guide


Get started with Synthesia API today and create the first video in just a few steps.

Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.