Descript API (1)

Download OpenAPI specification:Download

Getting started

Descript API is right now in close beta, to request access please fill this form.

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.