Vidéo et audio
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 · Interactive
Accès rapide
Fichiers d’entrée 1Fichiers de sortie 1–50
Entrée
Formats d’entrée et nombre de fichiers acceptés par cette Tool.
| Type d’entrée | file |
|---|---|
| Nombre de fichiers | 1 – 1 |
| MIME acceptés | video/mp4, video/webm, video/quicktime |
Paramètres
Transmettez ces valeurs via request.options.
| Paramètre | Type | Obligatoire | Par défaut | Valeurs / Plage | Description |
|---|---|---|---|---|---|
extractionMode |
enum | Optionnel | single |
single | interval | even | single extracts one timestamp, interval extracts every N seconds, and even extracts N frames across the video. |
timestamp |
number | Optionnel | 0 |
0 – ∞ | Thumbnail time in seconds. Used when input.data.times is not provided. |
intervalSeconds |
number | Optionnel | 5 |
0.1 – 3600 | For interval mode, extract one frame every N seconds. |
frameCount |
integer | Optionnel | 10 |
1 – 50 | For even mode, extract this many evenly spaced frames. |
format |
enum | Optionnel | jpg |
jpg | png | Output thumbnail format. |
quality |
number | Optionnel | 0.9 |
0.5 – 1 | JPG output quality from 0.5 to 1.0. |
maxLongSide |
integer | Optionnel | 0 |
0 – 4096 | Maximum thumbnail long side in pixels. 0 keeps the video resolution. |
Sortie
Format du résultat renvoyé après traitement.
| Type | files |
|---|---|
| Nombre de fichiers | 1 – 50 |
| MIME de sortie | image/jpeg, image/png |
| Metadata | width, height, duration, inputBytes, outputBytes, outputCount |
| Archive ZIP | Pris en charge · threshold 2 |
Utilisation de base
Choisissez un mode pris en charge et copiez le code de démarrage généré.
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.