Skip to content

Media Thumb

GET
/api/thumb/{path}
curl --request GET \
--url https://example.com/api/thumb/example \
--header 'Authorization: Bearer <token>'

Serve a still poster image for a media file.

Images are served as-is. Videos get a cached JPEG poster (first frame, which for i2v is the source image) extracted once with ffmpeg — rendering 135

path
required
Path
string

Successful Response

Media typeapplication/json
Examplegenerated
example

Validation Error

Media typeapplication/json
HTTPValidationError
object
detail
Detail
Array<object>
ValidationError
object
loc
required
Location
Array
msg
required
Message
string
type
required
Error Type
string
Examplegenerated
{
"detail": [
{
"loc": [
"example"
],
"msg": "example",
"type": "example"
}
]
}