Sample frames across a clip
sample_framesExtract evenly spaced or exact-timestamp video frames as separate images to review pacing, check continuity, read on-screen text, or describe scenes.
Instructions
Return several frames as separate images — evenly spaced across the clip (or a range), or at the exact times you list. Use it to review pacing, check continuity, read on-screen text, or describe what happens in a video. For a single overview image, contact_sheet is cheaper.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"path": "<path>"
},
"name": "sample_frames"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| end | No | Only look up to this time. | |
| path | Yes | Absolute path to a local video file. ~ is expanded. | |
| count | No | Evenly spaced frames to return (ignored if times is given). | |
| start | No | Only look from this time on. | |
| times | No | Exact timestamps to grab instead of evenly spaced ones. | |
| max_width | No |