video to thumbnail ffmpeg
Generate thumbnails from video with FFmpeg
If you need to generate thumbnails from video with FFmpeg, the usual goal is to capture one representative frame for previews, posters, or CMS workflows. This page shows the practical FFmpeg command, the matching FFmpeg API request, and an online tool you can test in the browser.
FFmpeg CLI
How to generate a video thumbnail in FFmpeg
A common FFmpeg thumbnail workflow seeks to a timestamp, captures a single frame, and writes the result as a JPG or PNG image.
FFmpeg thumbnail command
Click any part of the command to see what it does.
FFmpeg thumbnail command
ffmpeg
This runs the FFmpeg binary. The rest of the command defines the seek time, source file, and image output.
API
Use the same thumbnail workflow through the FFmpeg API
If you need video thumbnails inside your product, app, or backend workflow, the FFmpeg API gives you a faster path than building and maintaining your own preview-generation infrastructure. You can send one args-based request and reuse the same workflow in production.
Request
curl -X POST https://ffmpeg-api.cloud/v1/jobs \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"ffmpegArgs": [
"-y",
"-ss",
"00:00:02",
"-i",
"{{input}}",
"-frames:v",
"1",
"{{output}}"
],
"inputs": {
"input": {
"type": "url",
"url": "https://example.com/input.mp4"
}
},
"outputs": {
"output": {
"fileName": "thumbnail.jpg"
}
}
}'Response
{
"jobId": "job_01hxyz...",
"status": "queued",
"runtimeSeconds": 0,
"creditsCharged": 0,
"createdAt": "2026-04-14T10:30:00.000Z"
}Online tool
Try this FFmpeg API thumbnail tool online
Upload a source video, choose the capture time and output image format, and run the thumbnail job directly in the browser. It is the quickest way to validate preview frames before wiring the same request into your own app or backend.
Live playground
Generate thumbnails from video with FFmpeg
Capture a still frame from a source video with an args-based FFmpeg API request.
Use cases
Common ways to use FFmpeg video thumbnails
Thumbnail generation is useful when you want one lightweight preview image from a larger video asset.
Create preview cards and posters
Generate image thumbnails for CMS grids, media libraries, watch pages, or product surfaces that need a still preview.
Prepare assets for support and documentation
Capture a representative frame for help center articles, internal guides, or release notes without embedding the full video.
Feed downstream moderation or selection flows
Use still frames as lightweight review assets before later transforms or publishing steps in your backend.
FAQ
FFmpeg video thumbnail FAQ
Common questions about generating thumbnails with FFmpeg, choosing capture times, and moving the same workflow into the FFmpeg API.
Related templates
Other FFmpeg templates
Explore other FFmpeg templates for trimming, compression, resize, and more.