Video Thumbnail Extractor

video-thumbnail-extractor

Use Video Thumbnail Extractor through the Zavilo SDK. Check input limits, parameters, output and supported modes below.

H · HeadlessI · InteractiveE · Embedded

Tool-IDvideo-thumbnail-extractor

Version1

AusführungCLIENT

ModiHeadless, Interactive, Embedded

Schnellzugriff

Eingabedateien 1Ausgabedateien 1–50

Ergebnisverarbeitung → Rezepte → Integrationsbeispiele → Playground →

Eingabe

Zulässige Eingabeformate und Dateianzahl für dieses Tool.

Eingabetyp	file
Dateianzahl	1 – 1
Zulässige MIME-Typen	video/mp4, video/webm, video/quicktime

Parameter

Diese Werte über request.options übergeben.

Parameter	Typ	Erforderlich	Standard	Zulässig / Bereich	Beschreibung
`extractionMode`	enum	Optional	`single`	single \| interval \| even	single extracts one timestamp, interval extracts every N seconds, and even extracts N frames across the video.
`timestamp`	number	Optional	`0`	0 – ∞	Thumbnail time in seconds. Used when input.data.times is not provided.
`intervalSeconds`	number	Optional	`5`	0.1 – 3600	For interval mode, extract one frame every N seconds.
`frameCount`	integer	Optional	`10`	1 – 50	For even mode, extract this many evenly spaced frames.
`format`	enum	Optional	`jpg`	jpg \| png	Output thumbnail format.
`quality`	number	Optional	`0.9`	0.5 – 1	JPG output quality from 0.5 to 1.0.
`maxLongSide`	integer	Optional	`0`	0 – 4096	Maximum thumbnail long side in pixels. 0 keeps the video resolution.

Ausgabe

Nach erfolgreicher Verarbeitung zurückgegebenes Ergebnisformat.

Typ	files
Dateianzahl	1 – 50
Ausgabe-MIME	image/jpeg, image/png
Metadata	width, height, duration, inputBytes, outputBytes, outputCount
ZIP-Archiv	Unterstützt · threshold 2

Grundlegende Verwendung

Unterstützten Integrationsmodus wählen und den erzeugten Starter-Code kopieren.

Headless

const result = await client.run("video-thumbnail-extractor", {
  file,
  options: { extractionMode: "single", timestamp: 0, intervalSeconds: 5, frameCount: 10 }
});
console.log(result.files, result.data, result.metadata);

Interactive

await client.open({
  tool: "video-thumbnail-extractor",
  input: { file },
  options: { extractionMode: "single", timestamp: 0, intervalSeconds: 5, frameCount: 10 },
  onComplete(result) { console.log(result.files, result.data, result.metadata); }
});

Embedded

await client.mount({ tool: "video-thumbnail-extractor", target: "#zavilo-tool", mode: "embedded" });

This page is generated from the SDK Tool Definition used by the runtime.