get_video_frames_json
Extract evenly spaced frames from a video as base64 JPEGs with timestamps, enabling HTML galleries and visual skills to inspect specific video segments.
Instructions
Frames of a video as base64 JPEG with timestamps, for HTML galleries and skills. Same parameters, gate (confirm above 12) and cap (120) as get_video_frames. Read-only.
Args:
asset_id: The video asset's UUID.
count: Frames evenly spaced over the segment (default 6). Ignored when interval > 0.
size: 'thumbnail' (250px, ~1.6k tokens per frame) or 'preview' (1440px, ~6.4k). Default 'thumbnail'.
start: Segment start in seconds (default 0).
end: Segment end in seconds (0 = to the end).
interval: One frame every N seconds instead of count (1 = one per second, the maximum granularity).
confirm: Required (true) when more than 12 frames would be produced; ask the user first.
Returns: JSON {asset_id, duration, backend, count, frames:[{timestamp, data, type}]},
a confirmation plan {confirm_required, frames_planned, estimated_tokens, ...}, or {"error": ...}.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| end | No | ||
| size | No | thumbnail | |
| count | No | ||
| start | No | ||
| confirm | No | ||
| asset_id | Yes | ||
| interval | No |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |