Bulk Thumbnail Generator

Generate clean, high‑quality thumbnails from multiple videos at scale. Configure per‑video timestamp, format and quality. The Bulk Thumbnail Generator efficiently processes many video files or URLs in parallel, producing image thumbnails and storing them in the default key‑value store.

Features

• Scalable batch input: Process one or hundreds of videos in parallel.
• Timestamp control: Choose the exact second to capture a frame (default: 10s). If the timestamp exceeds the video length, the Actor automatically uses the last second of the video.
• Output formats: PNG or JPG.
• Quality presets: Best (1), Good (5), Medium (15), Low (31).
• Binary outputs to KV store: Images are saved to the default key‑value store.

Input

Available in Apify Console in the input tab.

• thumbnails (array, required): List of thumbnails to generate. Each item supports:
  • videoFile (string, required): Video file or direct URL. You can upload files in Console or pass URLs.
  • timestamp (integer, optional, default: 10): Second in the video to capture. If it exceeds the video length, the last second is used.
  • outputFormat (string, optional, default: png): One of png or jpg.
  • quality (string, optional, default: "1"): One of "1" | "5" | "15" | "31".

Example input:

{
  "thumbnails": [
    {
      "videoFile": "https://example.com/video-1.mp4",
      "timestamp": 8,
      "outputFormat": "jpg",
      "quality": "5"
    },
    {
      "videoFile": "https://example.com/video-2.mp4",
      "timestamp": 3
    },
    {
      "videoFile": "https://example.com/video-3.mp4",
      "outputFormat": "png",
      "quality": "1",
      "timestamp": 12
    }
  ]
}

Output

The Bulk Thumbnail Generator writes image binaries to the default key‑value store with keys:

• thumbnail-<index>-<timestamp>.<ext> (one per thumbnails item)
  • Example: thumbnail-0-12.png
  • <index> is the index of the item in the thumbnails array.
  • <timestamp> is the capture time in seconds, e.g., 12.
  • <ext> matches outputFormat (png or jpg).

Content types:

• image/png for png
• image/jpeg for jpg

You can download the images from the Run’s Key‑Value Store in Apify Console or via API. In Console, open the run → Key‑Value Store → select thumbnail-<index>-<timestamp>.<ext> → Download.

How it works

1. For each item in thumbnails, the Bulk Thumbnail Generator uses ffprobe to read the duration.
2. It clamps the requested timestamp if it’s beyond the video length.
3. It runs ffmpeg to extract a single frame and saves it.
4. The resulting image is stored in the default key‑value store as thumbnail-<index>-<timestamp>.<ext>.

Notes & limits

• One thumbnail per thumbnails item. To create multiple timestamps for the same video, add multiple items with the same videoFile and different timestamp values.
• Supported formats are those supported by ffmpeg (e.g., most common MP4/MOV/AVI/WebM).