Accessibility

Thumbnails

View Markdown

Overview

The thumbnails task generates thumbnail images from video files. Thumbnails are automatically selected from key frames in the video.


Creating a thumbnails task

curl -X POST "https://api.ittybit.com/tasks" \
-H "Authorization: Bearer ITTYBIT_API_KEY" \
-H "Content-Type: application/json" \
-d '{
  "url": "https://example.com/video.mp4",
  "kind": "thumbnails"
}'

Options

OptionTypeDescription
widthinteger or stringOutput width in pixels or percentage
heightinteger or stringOutput height in pixels or percentage
formatstringOutput format: jpeg (default) or png
{
  "url": "https://example.com/video.mp4",
  "kind": "thumbnails",
  "options": {
    "width": 640,
    "height": 360,
    "format": "jpeg"
  }
}

Output

When the task succeeds, the output contains thumbnail image files:

{
  "id": "task_abcdefgh12345678",
  "object": "task",
  "kind": "thumbnails",
  "status": "succeeded",
  "inputs": [...],
  "outputs": [
    {
      "kind": "source",
      "type": "image/jpeg",
      "width": 640,
      "height": 360,
      "url": "https://store.ittybit.net/..."
    }
  ],
  "created_at": 1735689825,
  "updated_at": 1735689886
}

Supported inputs

  • Video files: .mp4, .mov, .webm, .avi, .mkv

Common use cases

  • Video preview images for galleries and listings
  • Social media sharing cards
  • Video player poster frames
  • Content management system thumbnails

Image

Video

On this page