Skip to content

Video thumbnail

  • Type video.thumbnail
  • Group MZBase
  • Role action
  • Risk reads only
  • Side effect none
  • Runs once per item
  • Needs media

Takes one frame of a video as an image

Also available to AI agents and over MCP as a tool.

source

Source · string · required · default binary · one of binary, media

Where the input file comes from: the item’s file (binary), a media library item, or a URL.

binaryProperty

File field · string · optional · default data

Shown when source is binary.

mediaId

Media · string · optional

Shown when source is media.

atSeconds

At (seconds) · number · optional · default 1 · range 0 – …

The moment the frame is taken from.

format

Format · string · optional · default jpg · one of jpg, png, webp

width

Width · integer · optional · range 16 – 4096

into

Into field · string · optional · default data

saveTo

Save to · string · optional · default none · one of none, media

Where the result goes: back on the item as a file, or into the media library (the item then gets mediaId).

mediaFolder

Media folder · string · optional

Shown when saveTo is media.

mediaTags

Media tags · array · optional

Shown when saveTo is media.

  • main

← All nodes