---
title: Generate Thumbnail from Video Job API
slug: video-thumbnail
url: https://apyverse.com/apyhub/service/video-thumbnail
provider: ApyHub
tags: [video-thumbnail, thumbnail-generation, video-processing, async-jobs, media-preview]
auth: api_key
---

# Generate Thumbnail from Video Job API

What it does Video Thumbnail lets you submit a video file or a video URL and receive a thumbnail-generation job in return. It is designed for async processing: you send the source, optionally set size and time, and poll the job until the thumbnail is ready. Use /file-to-json when you have a multipa…

## Endpoints

| Method | Path | Description | Atoms |
| --- | --- | --- | --- |
| POST | `/job/generate/image-thumbnail/file` | What it does Submits a video file as a multipart upload to start a video thumbnail job. The endpoin… | 400 |
| POST | `/job/generate/image-thumbnail/url` | What it does Submits an async video thumbnail generation job using a source video URL. On success,… | 400 |
| GET | `/job/generate/image-thumbnail/status/:job_id` | What it does Checks the status of a video thumbnail generation job by jobid and returns the job rec… | 5 |

## About

## What it does
Video Thumbnail lets you submit a video file or a video URL and receive a thumbnail-generation job in return. It is designed for async processing: you send the source, optionally set `size` and `time`, and poll the job until the thumbnail is ready.

Use `/file-to-json` when you have a multipart video upload, or `/url-to-json` when the source is already hosted at a `video_url`. Both endpoints accept an optional `persistent` query flag. You can also control the frame position with `time` and request a specific output size with `size` in `WIDTHxHEIGHT` format. The immediate response gives you a `job_id` for status checks.

Call `GET /jobs/:job_id` to check progress. The job status returns `pending`, `successful`, or `failed`, along with the same `job_id`. When the job finishes successfully, the response includes a `url` pointing to the generated output.

Use Video Thumbnail when you need preview images for a media library, video upload flow, content CMS, or search results page. It keeps thumbnail generation decoupled from your request/response cycle, so you can handle larger files and remote sources without blocking your app.

## Usage

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