media_extract_frame
Capture a video frame at a specified timestamp and save it as PNG or JPG. Use this to review or verify a specific moment without altering the original media.
Instructions
Extract a single frame at a timestamp to an image file.
The source is never modified — the frame is written to
output_path. A vision-capable host can then read the still to
describe or QC the shot.
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": {
"file_path": "<file_path>",
"timestamp_sec": "<timestamp_sec>",
"output_path": "<output_path>"
},
"name": "media_extract_frame"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| file_path | Yes | Absolute path to the source video. | |
| output_path | Yes | Destination image path (``.png`` / ``.jpg``). | |
| timestamp_sec | Yes | Seek position in seconds. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |