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"}
.
Updated 12 months ago