inspect_media
Looks 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.
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. |