Order Audio Description

To order audio description, first you'll need a transcript from ordering human captions Order Human Captions or ASR Order ASR (auto-captions). Once you've ordered a transcript, you can order AD with the Order Audio Descriptions endpoint.

This will put an order on our system and begin your audio description job.

Getting AD Status

For testing purposes, you can check an audio description's status by hitting the Get Audio Descriptions by ID endpoint and checking the status field.

For Production applications, polling endpoints for status is an anti-pattern, so you'll want to specify a callback URL in your Order Audio Descriptions call. Whenever the order's status changes, we'll ping your API back.

Downloading your Audio Description Mix

Once your AD service is complete (status = complete), you can download your AD mix via the Download Audio Description Media endpoint. There are several formats you can choose from. Check the List Audio Description Mix Formats endpoint to see what's available (current values as of writing are {"wav", "mp3", "ogg", "mp4", "yt-mkv", "mkv"}.