Contact UsGet started
© 2025 Direct Cursus Technology L.L.C.

Video API, REST: Thumbnail.BatchGenerateDownloadURLs

Written by
Updated at August 8, 2025

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.

thumbnailIds[]

string

List of thumbnail IDs for which to generate download URLs.

Response

HTTP Code: 200 - OK

{
  "downloadUrls": [
    {
      "thumbnailId": "string",
      "originalUrl": "string",
      "scaledUrls": [
        {
          "url": "string",
          "maxWidth": "string",
          "maxHeight": "string",
          "imageFormat": "string"
        }
      ]
    }
  ]
}

Field

Description

downloadUrls[]

ThumbnailDownloadURL

List of download URLs for the requested thumbnails.
Each entry contains URLs for both the original image and various scaled versions.

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.
This provides access to the image at its original resolution and format.

scaledUrls[]

ScaledURL

List of URLs for downloading scaled versions of the thumbnail.
Different scaled versions are optimized for different display sizes and purposes.

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.
The actual width may be smaller to maintain the aspect ratio.

maxHeight

string (int64)

Maximum height in pixels of the scaled image.
The actual height may be smaller to maintain the aspect ratio.

imageFormat

enum (ImageFormat)

Format of the scaled image (JPEG, WebP, etc.).
Different formats offer different trade-offs between quality and file size.

  • IMAGE_FORMAT_UNSPECIFIED: The image format is not specified.
  • JPEG: JPEG image format.
    Provides good compression with some quality loss.
    Widely supported across all platforms and browsers.
  • WEBP: WebP image format.
    Provides better compression than JPEG with similar quality.
    May not be supported on all platforms and older browsers.
Previous
Create
Next
GenerateUploadURL