media_look
SEE the footage: decoded frames come back as an image you can look at. Give asset_id to look at one clip's source (times in source seconds), or leave it out to look at the timeline (times in timeline seconds; each frame is the top visible clip under the playhead). Pass times=[...] for exact moments, or start_s/end_s/count to sample a range (max 12). Several frames come back as one numbered contact sheet. Use it to check who is on camera, framing, a bad frame, which angle is which. Check already_noted first: if another agent wrote down what's there, you may not need to look. After looking, save what you learned with media_note. On a local project a timeline look is the FINISHED picture by default (as the preview shows it: zoom and position in the output frame, stacked tracks, transparency, Animate scenes; drawn by the desktop app; captions, shapes, grades and effects listed in words as not drawn). finished=false, a cloud project, or the desktop app being unavailable gives each clip's raw source frame instead, with a framing note saying which part of it the video shows. compare_revision=N also draws revision N of the timeline beside it (before | now).
response_detail (summary|ids|compact|full), fields (dotted paths), cursor (next page) — see the server instructions.
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": "media_look"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| count | No | ||
| end_s | No | ||
| sheet | No | ||
| times | No | ||
| cursor | No | ||
| fields | No | ||
| job_id | No | ||
| layers | No | ||
| start_s | No | ||
| asset_id | No | ||
| finished | No | ||
| response_detail | No | ||
| compare_revision | No |