Video API, REST: Thumbnail.BatchGenerateDownloadURLs
Generates download URLs for multiple thumbnails in a single request.
The response includes URLs for both original and scaled versions of each thumbnail.
This is useful for efficiently retrieving multiple thumbnails at once.
HTTP request
POST https://video.api.cloud.yandex.net/video/v1/thumbnails:batchGenerateDownloadURLs
Body parameters
{
"channelId": "string",
"thumbnailIds": [
"string"
]
}
|
Field |
Description |
|
channelId |
string Required field. ID of the channel containing the thumbnails. The maximum string length in characters is 50. |
|
thumbnailIds[] |
string List of thumbnail IDs for which to generate download URLs. The maximum string length in characters for each value is 50. The number of elements must be in the range 1-100. |
Response
HTTP Code: 200 - OK
{
"downloadUrls": [
{
"thumbnailId": "string",
"originalUrl": "string",
"scaledUrls": [
{
"url": "string",
"maxWidth": "string",
"maxHeight": "string",
"imageFormat": "string"
}
]
}
]
}
|
Field |
Description |
|
downloadUrls[] |
List of download URLs for the requested thumbnails. |
ThumbnailDownloadURL
|
Field |
Description |
|
thumbnailId |
string ID of the thumbnail for which download URLs are provided. |
|
originalUrl |
string URL for downloading the original, unmodified thumbnail image. |
|
scaledUrls[] |
List of URLs for downloading scaled versions of the thumbnail. |
ScaledURL
Represents a URL for a specific scaled version of a thumbnail image.
|
Field |
Description |
|
url |
string URL for downloading this scaled version of the thumbnail. |
|
maxWidth |
string (int64) Maximum width in pixels of the scaled image. |
|
maxHeight |
string (int64) Maximum height in pixels of the scaled image. |
|
imageFormat |
enum (ImageFormat) Format of the scaled image (JPEG, WebP, etc.).
|