Media Description Collections

Managing and utilizing collections of media descriptions

For more information about media descriptions, see Media Descriptions.

What are Media Description Collections?

Media Description Collections in Cloudglue enable you to describe multiple videos in a consistent format.

Unlike On-Demand Description which descibes each video individually and potentially with different settings, all videos inside a Media Description collection are transcribed the exact same way. Collections automatically transcribe each video as they are added in the collection, managing the flow for you, making it ideal for working with videos that are smiilar in concept.

This allows you to have a consistent way to understand the content of multiple videos.

Media Description collections also enable you to chat with the content of your videos. You can ask questions about the videos, search across all the videos in the collection and more.

Guiding the descriptions with a prompt

describe_config accepts an optional prompt: free-form guidance applied when every file in the collection is described. Because a collection exists to describe similar videos the same way, this is usually where guidance belongs — set it once at creation instead of repeating it on each request.

{
  "name": "Enterprise sales calls",
  "collection_type": "media-descriptions",
  "describe_config": {
    "enable_speech": true,
    "enable_scene_text": true,
    "enable_summary": true,
    "prompt": "Enterprise sales calls. Spell product names as Cloudglue, Aviary, and Foreman. Call out any pricing, contract terms, or renewal dates discussed."
  }
}

The prompt steers what the descriptions emphasize and how domain terms are spelled. It cannot make a description report content that isn’t in the video, and it doesn’t change the response shape. Like the rest of describe_config it is fixed at creation: files already in the collection were described under the original guidance, so changing it later would leave the collection inconsistent. Create a new collection to describe the same files under different guidance.

See On-Demand Describe for the per-request equivalent.