Skip to main content

POST Live Thumbnail Image

Overview

The table below provides information about the POST method for generating a thumbnail image from a live video by its ID.

POST Live Thumbnail Image
MethodPOST
URL or Endpointhttps://image.vpplayer.net/projectId/images/videoId/live-thumbnail.fileFormat
ParametersprojectId, videoId, fileFormat, width, height
BodyNot Applicable

The description of the URL and body parameters is as follows:

Parameter NameLocationMandatoryTypeDescription
projectIdPathYesstringUnique ID of the project.
videoIdPathYesstringUnique ID of the video.
fileFormatPathYesstringImage format (jpg, jpeg, and webp are supported).
widthQueryNointegerWidth of the output thumbnail image.
heightQueryNointegerHeight of the output thumbnail image.

Request Body

No request body is required for this POST method.

Response

If the request has been accepted successfuly, the response will return a 200 OK status with a plain text message:

Request has been accepted and it is being processed.

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