Preview source video
Source-generated preview_video arguments, output schema, OAuth scope, and safety annotations for the reviewed MCP contract.
On this page
Tool
preview_video
Get a labeled contact sheet at up to 12 timestamps, with actual source times. Uses no AI or credits; subject to storage quota and media budgets. Returns a signed image URL, not inline image bytes; fetch it without credentials to inspect. Does not preview final alpha quality.
Permissions and safety
OAuth scope: assets:read
| Signal | Value |
|---|---|
destructiveHint |
false |
idempotentHint |
true |
openWorldHint |
false |
readOnlyHint |
false |
| spendsCredits | false |
| requiresUserConfirmation | false |
| sideEffects | preview_asset_cached, signed_url_issued |
Annotations describe safety properties; they do not replace consent, OAuth authorization, or server checks.
Input arguments
| Field | Type | Required | Default | Constraints | Meaning |
|---|---|---|---|---|---|
asset_id |
string |
Yes | — | format: uuid |
— |
request |
VideoPreviewRequest | Yes | — | — | — |
Argument example
{
"asset_id": "00000000-0000-4000-8000-000000000003",
"request": {
"max_frame_size": 256,
"timestamps_seconds": [
0,
1,
2
]
}
}
Structured result
| Field | Type | Required | Default | Constraints | Meaning |
|---|---|---|---|---|---|
cells |
array<PreviewCell> | Yes | — | — | Thumbnails in request order, preserving duplicates. |
height |
integer |
Yes | — | — | Contact sheet height in pixels, including labels and padding. |
image |
AssetResponse | Yes | — | — | Cached PNG contact sheet with a refreshable signed download URL. |
object |
string |
No | "video_preview" |
const: "video_preview" |
— |
source_video_asset_id |
string |
Yes | — | format: uuid |
Stable source video asset ID. |
width |
integer |
Yes | — | — | Contact sheet width in pixels, including labels and padding. |
Errors and next steps
Tool errors contain an error object with code, message, retryable, request_id, and details. Do not parse message text or leak private inputs. Inspect partial outputs after a terminal failure; a signed URL is not a saved file.
Was this page helpful?
No search queries, code, or free text are collected. This switch controls documentation interactions only; general site analytics follow the privacy policy. Privacy policy