wiro / video-thumbnail

## Overview Video Thumbnail by Wiro extracts still frames from an existing video. It samples the timeline and saves the chosen frames as image files. You can pull one poster frame at a specific moment, or generate many evenly spaced frames across the full clip. This helps you create clean preview images and thumbnail candidates without manual scrubbing. ## What you can build - Poster-frame thumbnails for a video player or landing page - Multi-frame thumbnail sets for review, QA, or content moderation - A/B thumbnail candidates for creator workflows before publishing - Preview images for a CMS or media library - Frame grabs for product demos, tutorials, and documentation ## Inputs - One input video to extract frames from. Provide a direct URL or upload a file. Common Wiro video uploads include MP4, WebM, and MOV. File uploads to Wiro are capped at 100 MB per file. - How many thumbnails you want returned, from 1 to 20. When you request multiple thumbnails, the tool spreads them evenly across the whole video. - An optional capture time for single-thumbnail runs. You can provide seconds (including decimals like 12.5) or a timecode string like 00:01:02. If you leave it blank, the tool captures a frame about 10% into the video to avoid black intros. - The image format to save: JPG, PNG, or WebP. - Optional thumbnail width and/or height in pixels (16 to 7680). If you set only one dimension, the other dimension follows the original aspect ratio. If you set both, the frame can stretch to that exact size. If you request a size larger than the source video, the tool falls back to the video’s original dimensions. ## Outputs The model returns one or more image outputs, one per extracted frame. Each output is an image file in your selected format (JPG, PNG, or WebP). Wiro returns outputs as CDN-hosted files, with a filename, a MIME type (such as image/png), a byte size, and a downloadable URL. ## Limitations - This tool extracts frames that already exist in the video. It does not generate new imagery or enhance quality. - If you request more than one thumbnail, any single “capture time” you provide is ignored. - Timestamp capture accuracy depends on the source encoding. Some codecs and keyframe spacing can limit exact-frame selection. - If you force both width and height, images may look stretched if the aspect ratio changes. - Low-quality inputs can produce poor thumbnails. This includes heavily compressed video, very low resolution, dark intros, letterboxing, corrupted files, or inconsistent frame timing. ## Safety & compliance Only upload videos you own or have permission to use. Respect copyrights, privacy rights, and publicity rights. Wiro output file URLs are publicly accessible to anyone with the link. Don’t share links to sensitive thumbnails. Download outputs to your own private storage if needed.