Zoom
media_zoomExtracts a single readable frame from a local video at a given timestamp or window, or renders one page of a local document, optionally cropped, so you can read on-screen text or details that storyboard grids are too small to show.
Instructions
Get a close-up of one moment in a local video, or one page of a local document, returned as a single image. (取本地视频某一时刻的特写单帧，或本地文档某一页的整页 / 局部放大图。)
Use it after media_overview when one cell or page needs a closer look: "what exactly is on screen at 01:12?" "what does line 3 of page 7 say?"
For video, pass at (a single timestamp) or start/end (a window — the sharpest frame inside it is returned, and the exact timestamp is reported back). For a document, pass page, optionally with crop. crop is {x, y, width, height}, each a fraction 0..1 of the frame or page, origin top-left.
Keep it to one frame. It costs roughly 1,900 vision tokens — far more than a whole overview cell. Zoom the parts that matter instead of re-scanning the file.
This is the ONLY tool whose image is meant for reading. A storyboard cell is a few hundred pixels wide and the text inside it is unreadable; a cropped single frame at up to 1600 px is readable. So: locate in the overview grid, then zoom to read. The returned image is always source "visual" — what you read off it is your own reading of pixels, not a transcript, so treat it as an observation rather than a quotation.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| at | No | Exact timestamp in seconds for a video frame. Mutually exclusive with start/end. Applicable to video only. (精确时刻，秒) | |
| end | No | Window end in seconds (closed interval, both ends included). Applicable to video and audio only. Defaults to the end of the media; a value past the end is clipped and reported. (终点，秒) | |
| crop | No | Crop rectangle {x, y, width, height}: all four required, each a fraction 0..1 of the frame or page, origin top-left. Applicable to video and document only. (裁切区域，比例制) | |
| page | No | 1-based page number to render. Required for document media; not applicable to video. (页码) | |
| path | Yes | Absolute path to a LOCAL file: video, audio recording, or document. URLs and relative paths are rejected — this server never downloads anything. (本地文件绝对路径) | |
| start | No | Window start in seconds (closed interval, both ends included). Applicable to video and audio only; document media uses "pages" instead. Default 0. (起点，秒) | |
| maxEdge | No | Longest edge of each image in pixels: 256-1600. Default 1280 for overview, 1600 for zoom. Applicable to video and document only. (单张图最长边) |