Update a video thumbnail

Body Params

video_key must be sent with each /videos/thumbnails/update request.

string

Key of the video whose thumbnail should be set.

integer

(float) Video frame position in seconds from which thumbnail should be generated. Seconds can be given as a whole number (e.g: 7) or with the fractions (e.g.: 7.42).

Several images are automatically generated during the conversion process. If the position parameter is present in the /videos/thumbnails/update call, a thumbnail is created from the image nearest to the position value. Otherwise, an URL will be returned to which the thumbnail file can be uploaded.

After thumbnail file has been uploaded, a series of images will be generated with the following width: 40, 120, 320, 480, 720 and 1280. Generated thumbnail images will be saved in JPEG format.

Supported image formats for uploaded thumbnail files: JPEG, PNG.

See Thumbs section of the Delivery API documentation for information on how to construct a thumbnail URL.

WARNING: It is not possible to generate thumbnail using position parameter if original video has been deleted. Additionally, if position is specified, thumbnail_index cannot be included in the request.

integer

(unsigned integer) Index of the image in the thumbnail strip to use as a video thumbnail. Thumbnail index starts from 1.
WARNING: If thumbnail_index is specified, position cannot be included in the request.

string

Thumbnail file MD5 message digest. If supplied, it will be checked by the API.

integer

(unsigned integer) Thumbnail file size. If supplied, it will be checked by the API.

Headers
string
enum
Defaults to application/xml

Generated from available response content types

Allowed:
Responses

Language
URL
LoadingLoading…
Response
Choose an example:
Position or thumbnail specified in request
Neither position nor thumbnail specified in request
Response
© 2007- Longtail Ad Solutions, Inc.