Video Create Session
video_create_sessionCreate a persistent session for multi-turn video exploration from a YouTube URL or local file, enabling context-cached follow-up questions.
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.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "video_create_session"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| url | No | YouTube video URL. | |
| scope | No | Exact workspace/notebook isolation for sessions and derived memory; omit for legacy unscoped sessions | |
| 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. | |
| file_path | No | Path to a local video file. | |
| description | No | Session purpose or focus area |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||