Takes a video (up to 24 MB) and returns the best poster frames
Takes a video (up to 24 MB) and returns the best poster frames: candidates are spread over the running time, and for each segment ffmpeg's thumbnail filter selects the frame closest to the segment average, which avoids transitions, flashes and motion blur. Candidates that are almost black or very flat are dropped. The best candidates come back as JPEG at the chosen width, each with timestamp and mean brightness, ranked by brightness balance and contrast. Runs locally with ffmpeg.
Paid test badge: not yet. The checks above are free: we call the tool without paying and read the payment request it sends back. The Verified badge needs paid calls whose answers match the promised output, and nobody can buy a badge.
Endpoint
POST https://medien.halowerk.com/v1/video-thumbnail
| Category | Image and media |
|---|---|
| Provider host | medien.halowerk.com |
| Networks | eip155:8453 |
| Payment schemes | exact |
| Self-reported calls, 30 days | 1 from 1 payers (the provider's figure, not ours) |
Our checks, last 30 days
| Day | Result | HTTP | Asked | Time |
|---|---|---|---|---|
| 2026-10-31 | valid payment request | 402 | $0.004 | 1032 ms |
Example input (from the provider)
{
"body": {
"candidates": 2,
"source": {
"url": "https://medien.halowerk.com/beispiel/vortrag.mp4"
},
"width": 320
},
"bodyType": "json",
"method": "POST",
"type": "http"
}
Promised output schema (from the provider)
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"input": {
"additionalProperties": false,
"properties": {
"body": {
"additionalProperties": false,
"properties": {
"candidates": {
"default": 3,
"maximum": 8,
"minimum": 1,
"type": "integer"
},
"source": {
"additionalProperties": false,
"properties": {
"content_base64": {
"maxLength": 12000000,
"type": "string"
},
"filename": {
"maxLength": 260,
"type": "string"
},
"url": {
"maxLength": 2048,
"type": "string"
}
},
"type": "object"
},
"width": {
"default": 640,
"maximum": 1920,
"minimum": 120,
"type": "integer"
}
},
"required": [
"source"
],
"type": "object"
},
"bodyType": {
"enum": [
"json",
"form-data",
"text"
],
"type": "string"
},
"method": {
"enum": [
"POST",
"PUT",
"PATCH"
],
"type": "string"
},
"type": {
"const": "http",
"type": "string"
}
},
"required": [
"type",
"method",
"bodyType",
"body"
],
"type": "object"
}
},
"required": [
"input"
],
"type": "object"
}