> ## Documentation Index
> Fetch the complete documentation index at: https://developers.fastdrop.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Extract Thumbnails

> Extract keyframe thumbnails without classification

Extract 3-5 keyframe thumbnails from a video. No classification is performed — just thumbnail extraction.

**Cost:** 1 credit

<ParamField body="video_url" type="string" required>
  Public HTTP/HTTPS URL of the video.
</ParamField>

<ParamField body="webhook_url" type="string">
  Optional HTTPS URL to receive a POST when processing completes.
</ParamField>

### Response (202 Accepted)

Returns a job submission with `job_id`. Get the result from [Get Job Status](/api-reference/get-job-status) with `?wait=N`, or subscribe to `job.completed` via a [webhook](/guides/webhooks). When complete, the `results.thumbnails` field contains an array of presigned thumbnail URLs.

<RequestExample>
  ```bash cURL theme={null}
  curl -X POST https://api.fastdrop.io/api/v1/thumbnails \
    -H "Content-Type: application/json" \
    -H "X-API-Key: fd_live_your_key_here" \
    -d '{"video_url": "https://example.com/video.mp4"}'
  ```
</RequestExample>

<ResponseExample>
  ```json 202 theme={null}
  {
    "job_id": "a1b2c3d4-5678-90ab-cdef-1234567890ab",
    "status": "queued",
    "credits_charged": 1,
    "estimated_seconds": 60,
    "poll_url": "/api/v1/classify/a1b2c3d4-5678-90ab-cdef-1234567890ab",
    "created_at": "2026-03-05T12:00:00Z"
  }
  ```
</ResponseExample>

### Result format

When the job completes, the `results` field contains:

```json theme={null}
{
  "thumbnails": [
    "https://storage.fastdrop.io/thumbs/abc123-t1.jpg",
    "https://storage.fastdrop.io/thumbs/abc123-t2.jpg",
    "https://storage.fastdrop.io/thumbs/abc123-t3.jpg"
  ]
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.