---
title: Generate Thumbnail from Video Job API
slug: generate-video-thumbnail-job-api
url: https://apyhub.com/apyhub/service/generate-video-thumbnail-job-api
provider: ApyHub
categories: [File Conversion, File Manipulation]
auth: api_key
---

# Generate Thumbnail from Video Job API

Create a thumbnail from a video file or URL, choose the frame time and output size, and poll for a result URL.

## Endpoints

| Method | Path | Description | Atoms |
| --- | --- | --- | --- |
| POST | `/job/generate/image-thumbnail/file` | What it does Submits a video file as a multipart upload to start an asynchronous video thumbnail jo… | 400 |
| GET | `/job/generate/image-thumbnail/status/:job_id` | What it does Checks the status of a video thumbnail generation job identified by jobid and returns… | 5 |
| POST | `/job/generate/image-thumbnail/url` | What it does Submits a video thumbnail generation job using a source video URL and returns a job id… | 400 |

## About

## What it does
Video Thumbnail Generator creates a thumbnail frame from a video you upload or reference by URL. Send a video file or a `video_url`, optionally set `time` to choose the frame position in seconds and `size` to request an output in `WIDTHxHEIGHT` with even integers.

Submit the job and get back a `job_id` immediately. Poll `GET /jobs/:job_id` to check whether the job is `pending`, `successful`, or `failed`. When the job finishes successfully, the status response includes a `url` for the generated output. If the job is still running or has failed, the response also includes a human-readable `message`.

Use Video Thumbnail Generator when you need a preview image or frame capture for a media library, upload flow, content management system, or video catalog. The API supports asynchronous processing, so you can accept larger files without blocking the request that starts the job.

If you need the result to remain available, set `persistent` on submission. Otherwise, use the returned `url` from the job status response to retrieve the generated thumbnail output.

## Usage

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