What is On-Demand Media Description?
On-Demand Media Description allows you to describe a video, exactly as you need it, when you need it. It is a great to use when you have one-off videos that you want to describe, or, when you want to get deeper descriptions for just one or a set of particular videos. You can use this to quickly get the speech transcripts of a single YouTube video, or get more in-depth descriptions that include scenes and visual descriptions for a different video. You can control the level of description you want to perform, to get the most out of your videos. If you’re finding that you need to describe a lot of videos, in the same format, then you should consider using a Media Description Collection.How to use it
You can describe a video on-demand by using the Describe API.Describing images
On-Demand Describe also works on still image files. Images are described at the file level only (no segmentation) and billed at a flat 1 credit per request. Because an image has no audio track,enable_speech and
enable_audio_description are not available for images — describe defaults to a
visual description (visual scene description, scene text, and summary).
Speaker identification
Whenenable_speech is on, the transcript labels each turn with a speaker. For files added through a data connector that carries an attendee list (e.g. Grain), those real names are used automatically.
For uploaded files — which have no attendee metadata — you can pass the cast yourself via the optional participants field. When provided, speaker naming is constrained to that list: each speaker is matched to one of the supplied names or left as a generic Speaker N, and names that aren’t on the list are never invented.