video_create_session
Start a persistent session for analyzing videos from YouTube URLs or local files, enabling multi-turn exploration and research with optional caching for faster subsequent interactions.
Instructions
Create a persistent session for multi-turn video exploration.
Provide exactly one of url or file_path. When download=True and the
source is YouTube, the video is downloaded via yt-dlp, uploaded to the
Gemini File API, and context-cached for fast multi-turn use.
Args: url: YouTube video URL. file_path: Path to a local video file. description: Optional focus area for the session. download: Download YouTube video for cached sessions.
Returns: Dict with session_id, status, video_title, source_type, cache/download status, and optional local_filepath when a local file is available.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| url | No | ||
| file_path | No | ||
| description | No | Session purpose or focus area | |
| download | No | Download YouTube video locally for cached multi-turn sessions. Slower startup (~2 min) but faster and cheaper per turn. Requires yt-dlp installed. |