GET Thumbnail Image
Overview
The table below provides information about the GET method for retrieving the thumbnail from a video by its ID.
| GET Thumbnail Image | |
|---|---|
| Method | GET |
| URL or Endpoint | https://cdn.vpplayer.tech/projectId/images/videoId/thumbnail.fileFormat |
| Parameters | projectId, videoId, fileFormat, time, width, height |
| Body | Not Applicable |
The description of the URL and query parameters is as follows:
| Parameter Name | Location | Mandatory | Type | Description |
|---|---|---|---|---|
projectId | Path | Yes | string | Unique ID of the project. |
videoId | Path | Yes | string | Unique ID of the video. |
fileFormat | Path | Yes | string | Image format (jpg, jpeg, webp are supported). |
time | Query | No | integer | Time in seconds within the video timeline at which the thumbnail should be generated. |
width | Query | No | integer | Width of the generated thumbnail. |
height | Query | No | integer | Height of the generated thumbnail. |
Request Body
The GET method does not require a request body.
Response
If the image generation is successful, a 200 OK response will return the animated image in the requested format.
If the image is still being processed, the response may return a 202 Accepted status with a plain text message:
The image generation request is still being processed! Please try again!
Errors
For information about the errors that are common to all actions, see Common Errors:
HTTP Status Code 400: Bad Request
HTTP Status Code 401: Unauthorized
HTTP Status Code 403: Forbidden
HTTP Status Code 404: Result Not Found
HTTP Status Code 500: Internal Server Error
HTTP Status Code 503: Backend Fetch Failed
HTTP Status Code 503: Backend Fetch Failed