---
title: Generate Thumbnail from Video API
slug: generate-thumbnail-from-video
url: https://apyhub.com/apyhub/service/generate-thumbnail-from-video
provider: ApyHub
categories: [Media Kit]
tags: [video-thumbnail, video-frame, video-processing]
auth: api_key
version: 1.0.0
service_type: sync
endpoints: 4
atoms: 550
mcp: true
alias: thumbnail-from-video
---

# Generate Thumbnail from Video API

Extract a PNG frame from a video file or URL at any timestamp. Returns binary output or a signed link for previews, galleries, and cards.

## Endpoints

| Method | URL | Description | Atoms |
| --- | --- | --- | --- |
| POST | `https://api.eu.apyhub.com/apyhub/generate-thumbnail-from-video/file/download` | What it does Extracts a single PNG frame from an uploaded video and streams the generated file back… | 550 |
| POST | `https://api.eu.apyhub.com/apyhub/generate-thumbnail-from-video/file/link` | What it does Uploads a video file and returns a signed link to a generated PNG frame extracted from… | 550 |
| POST | `https://api.eu.apyhub.com/apyhub/generate-thumbnail-from-video/url/download` | What it does Extracts a PNG frame from a remote video URL and returns it as a streamed binary respo… | 550 |
| POST | `https://api.eu.apyhub.com/apyhub/generate-thumbnail-from-video/url/link` | What it does Extracts a PNG frame from a remote video URL and returns a signed link to the generate… | 550 |

## Endpoint reference

### Extract PNG frame from upload and stream download 

`POST https://api.eu.apyhub.com/apyhub/generate-thumbnail-from-video/file/download` · 550 atoms · accepts `multipart/form-data` · returns `application/json`

| Parameter | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `size` | body | string | no | Optional output scale WxH. Example: `320x180`. |
| `time` | body | integer | no | Frame seek position in seconds. Default: `1`. Example: `3`. |
| `video` | body | string (binary) | yes | Video file (.mp4 .mkv .avi .mov .flv .3gp .webm). Max 500 MiB. |

#### Quickstart

Upload a video file to generate a thumbnail from it.

```bash
curl -X POST "https://api.eu.apyhub.com/apyhub/generate-thumbnail-from-video/file/download" \
  -H "apy-token: $APY_TOKEN" \
  -F "video=@/path/to/video.mp4"
```

#### What you'll get back

Returns the generated thumbnail as a binary file response.

### Extract PNG frame from upload and return signed link (VIT-02)

`POST https://api.eu.apyhub.com/apyhub/generate-thumbnail-from-video/file/link` · 550 atoms · accepts `multipart/form-data` · returns `application/json`

| Parameter | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `size` | body | string | no | Example: `640x360`. |
| `time` | body | integer | no | Default: `1`. |
| `video` | body | string (binary) | yes |  |

#### Quickstart

Upload a video file to generate a thumbnail from it.

```bash
curl -X POST "https://api.eu.apyhub.com/apyhub/generate-thumbnail-from-video/file/link" \
  -H "apy-token: $APY_TOKEN" \
  -F "video=@/path/to/video.mp4"
```

#### What you'll get back

Returns a JSON object with a `data` string field containing the generated thumbnail URL.

```json
{
  "data": "https://storage.example.com/video-clips/thumb.png?sig=abc"
}
```

### Extract PNG frame from remote URL and stream download (VIT-03)

`POST https://api.eu.apyhub.com/apyhub/generate-thumbnail-from-video/url/download` · 550 atoms · accepts `application/json` · returns `application/json`

| Parameter | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `size` | body | string | no | Example: `320x180`. |
| `time` | body | string | no | Default: `1`. Example: `3`. |
| `video_url` | body | string (uri) | yes | Example: `https://assets.apyhub.com/samples/sample.mp4`. |

#### Quickstart

Generate a thumbnail from a video URL by sending the video link in the request body.

```bash
curl -X POST "https://api.eu.apyhub.com/apyhub/generate-thumbnail-from-video/url/download" \
  -H "apy-token: $APY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"video_url":"https://assets.apyhub.com/samples/sample.mp4"}'
```

#### What you'll get back

Returns a binary file containing the generated thumbnail image.

### Extract PNG frame from remote URL and return signed link (VIT-04)

`POST https://api.eu.apyhub.com/apyhub/generate-thumbnail-from-video/url/link` · 550 atoms · accepts `application/json` · returns `application/json`

| Parameter | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `size` | body | string | no | Example: `320x180`. |
| `time` | body | string | no | Default: `1`. Example: `3`. |
| `video_url` | body | string (uri) | yes | Example: `https://assets.apyhub.com/samples/sample.mp4`. |

#### Quickstart

Generate a thumbnail from a video URL by sending the video link and the target thumbnail size.

```bash
curl -X POST "https://api.eu.apyhub.com/apyhub/generate-thumbnail-from-video/url/link" \
  -H "apy-token: $APY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "video_url": "https://assets.apyhub.com/samples/sample.mp4",
    "size": "320x180"
  }'
```

#### What you'll get back

Returns a JSON object with a `data` string field containing the thumbnail image URL.

```json
{
  "data": "https://storage.example.com/video-clips/thumb.png?sig=abc"
}
```

## About

## What it does
Video Thumbnail Generator extracts a PNG frame from a video at a specific timestamp. Send a video file or a remote video URL, choose the seek time in seconds, and optionally set an output size like `320x180` or `640x360`.

Use the upload-based endpoints when you already have the media in hand, or the URL-based endpoints when the file is hosted elsewhere. You can choose between a streamed binary image response or a signed URL response, depending on how you want to handle the thumbnail in your app.

Video Thumbnail Generator accepts common video formats including `.mp4`, `.mkv`, `.avi`, `.mov`, `.flv`, `.3gp`, and `.webm`. The file-based download endpoint supports uploads up to 500 MiB. The response is a PNG frame, either returned directly as binary data or provided as a signed link in a `data` field.

This is useful for generating preview images for video galleries, media upload flows, asset management systems, and content moderation dashboards where a stable frame capture is needed for display or indexing.

## Usage

Base URL: `https://api.eu.apyhub.com` (default region — see
`GET https://apyhub.com/api/public/regions` for the rest).

Authenticate with an ApyHub API key in the `apy-token` header.
Full docs and a live playground: https://apyhub.com/apyhub/service/generate-thumbnail-from-video
