describe_video
Describe videos from YouTube, Cloudglue, and direct URLs. Automatically reuses existing descriptions to save costs, and paginates results in 5-minute segments.
Instructions
Gets comprehensive video descriptions with intelligent cost optimization and pagination support. Automatically checks for existing descriptions before creating new ones. Supports YouTube URLs, Cloudglue URLs, and direct HTTP video URLs with different analysis levels. Results are paginated in 5-minute segments - use the 'page' parameter to retrieve specific time segments of longer videos (page 0 = first 5 minutes, page 1 = next 5 minutes, etc.). Use 'start_time_seconds' to begin pagination from a specific time index (defaults to 0 for start of video). The combination of start_time_seconds and page allows precise navigation: start_time_seconds sets the base offset, and page increments in 5-minute segments from that offset. When collection_id is provided (from a media-descriptions collection), this tool fetches previously extracted descriptions that were stored in that collection for the given Cloudglue file, saving time and cost. Use this for individual video analysis.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| url | Yes | Video URL to describe. Supports multiple formats: • **Cloudglue platform (default)**: `cloudglue://files/file-id` - Use file ID from list_videos • **YouTube URLs**: `https://www.youtube.com/watch?v=...` or `https://youtu.be/...` • **Public HTTP video URLs**: Direct links to MP4 files (e.g., `https://example.com/video.mp4`) • **Data connector URLs** (requires setup in Cloudglue account): - **Dropbox**: Shareable links (`https://www.dropbox.com/scl/fo/...`) or `dropbox://<path>/<to>/<file>` - **Google Drive**: `gdrive://file/<file_id>` - **Zoom**: Meeting UUID (`zoom://uuid/QFwZYEreTl2e6MBFSslXjQ%3D%3D`) or Meeting ID (`zoom://id/81586198865`) See https://docs.cloudglue.dev/data-connectors/overview for data connector setup. | |
| collection_id | No | Optional collection ID to fetch previously extracted media descriptions from a media-descriptions collection (saves time and cost). Use collection ID from list_collections without. When provided with a Cloudglue URL, this tool retrieves existing descriptions that were previously extracted and stored in the specified collection. Only works with Cloudglue URLs. | |
| page | No | Page number for paginated results. Each page contains 5 minutes of video content. Defaults to 0 (first page). Use this to retrieve descriptions for specific time segments of longer videos. Increase the page number to get the next 5-minute segment. Works in conjunction with start_time_seconds - page 0 starts from start_time_seconds, page 1 starts 5 minutes after start_time_seconds, etc. | |
| start_time_seconds | No | Starting time offset in seconds for pagination. Defaults to 0 (start of video). Use this to begin pagination from a specific time index in the video. Combined with the page parameter, this allows you to navigate to specific time ranges: start_time_seconds sets the base offset, and page increments in 5-minute segments from that offset. For example, start_time_seconds=600 (10 minutes) with page=0 returns content from 10-15 minutes, page=1 returns 15-20 minutes, etc. |