Inspect source frames
inspect_mediaLooks INSIDE a source asset. Returns ONE contact sheet — every requested moment as a labelled cell in a single grid image — plus a per-cell fingerprint. Pass atSec (max 12 timestamps, seconds); combine with get_media's sceneSamples for an instant storyboard of the whole file. Shows the RAW source; use inspect_timeline for the composed cut. START WITH pixels:false WHEN YOU ARE ONLY CHECKING FOR EMPTINESS. The fingerprint answers 'is this black / flat / did it decode' for no image cost — nonBlankRatio near 0 is an empty or black frame, colorRange near 0 is a featureless one. Ask for pixels when you must judge WHAT is in the frame: subject, framing, legibility.
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": {
"projectId": "<projectId>",
"mediaRef": "<mediaRef>",
"atSec": "<atSec>",
"token": "<token>"
},
"name": "inspect_media"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| atSec | Yes | Timestamps in seconds, max 12. | |
| token | Yes | The session token `connect` returned. Pass it on every call — it says which browser to drive. | |
| pixels | No | False = fingerprints only, no image (default true). | |
| columns | No | Grid columns (default 3, or one row if ≤3). | |
| mediaRef | Yes | Asset from get_media. | |
| projectId | Yes | Project id from get_projects. | |
| cellHeight | No | Target px height per cell (default 300). Shrunk automatically if the sheet would exceed the response budget — the reply says so when that happens. |