Skip to main content

POST Live Animated Image

Overview

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

POST Live Animated Image
MethodPOST
URL or Endpointhttps://image.vpplayer.net/projectId/images/videoId/live-animated.fileFormat
ParametersprojectId, videoId, fileFormat, duration, fps, width
BodyNot Applicable

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

Parameter NameLocationMandatoryTypeDescription
projectIdPathYesstringUnique ID of the project.
videoIdPathYesstringUnique ID of the video.
fileFormatPathYesstringImage format (webp and gif are supported).
durationQueryNointegerDuration in seconds of the animation to be generated.
fpsQueryNointegerFrames per second for the animation.
widthQueryNointegerWidth of the output 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