Download OpenAPI specification:Download
Descript API is right now in close beta, to request access please fill this form.
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.
curl -H "authorization: Bearer ${YOUR_PERSONAL_TOKEN}" https://descriptapi.com/v1/overdub/voices
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"}