Descript API (1)

Download OpenAPI specification:Download

Access to the Overdub API is available only and exclusively to Descript Enterprise customers.

Authentication

Descript API uses a personal token to authenticate your request. You can get your personal token by contacting us. The personal token should be used as a bearer token in the authorization header.

Authentication example

curl -H "authorization: Bearer ${YOUR_PERSONAL_TOKEN}" https://descriptapi.com/v1/overdub/voices

Example

Generate audio

In this part, we will generate our first audio with the Overdub API.

You will first need to find the id of the Voice with which to generate:

curl --request GET \
--url https://descriptapi.com/v1/overdub/voices \
--header 'authorization: Bearer ${YOUR_PERSONAL_TOKEN}'

Once you pick your voice-id, generate an async task:

curl --request POST \
    --url https://descriptapi.com/v1/overdub/generate_async \
    --header 'authorization: Bearer ${YOUR_PERSONAL_TOKEN}' \
    --header 'content-type: application/json' \
    --data '{
    "text": "Hey everyone, this is a generated audio",
    "voice_id": "${VOICE_ID}"
    }'
### Result {"id": "fc0a16f9-9bac-46f5-8917-ef9ea50531bb","state": "queued"}

Now fetch the result of the task (should be available after a few seconds):

curl --request GET \
    --url https://descriptapi.com/v1/overdub/generate_async/fc0a16f9-9bac-46f5-8917-ef9ea50531bb \
    --header 'authorization: Bearer ${YOUR_PERSONAL_TOKEN}'
### Result {"id": "fc0a16f9-9bac-46f5-8917-ef9ea50531bb","state": "done", "url":"https:url-to-audio.wav"}

Overdub

Overdub API allows you to generate audio with your Descript Overdub Voice.

Generate a new Overdub.

It will create an Overdub generate async task. Use the get endpoint to fetch the job result. Usually, a task should take a few seconds. You can provide an optional callback_url as a parameter to this request. We will do a post to this url once the overdub is ready. There are two types of Overd