Yandex Cloud
Search
Contact UsGet started
  • Blog
  • Pricing
  • Documentation
  • All Services
  • System Status
    • Featured
    • Infrastructure & Network
    • Data Platform
    • Containers
    • Developer tools
    • Serverless
    • Security
    • Monitoring & Resources
    • ML & AI
    • Business tools
  • All Solutions
    • By industry
    • By use case
    • Economics and Pricing
    • Security
    • Technical Support
    • Customer Stories
    • Gateway to Russia
    • Cloud for Startups
    • Education and Science
  • Blog
  • Pricing
  • Documentation
Yandex project
© 2025 Yandex.Cloud LLC
Yandex Cloud Video
    • Overview
    • Control
    • Troubleshooting
  • Access management
  • Pricing policy
    • Authentication with the API
    • Getting started with the API
      • Overview
        • Overview
        • Get
        • List
        • Create
        • BatchGenerateDownloadURLs
        • GenerateUploadURL
        • Delete
  • Audit Trails events
  • Release notes

In this article:

  • HTTP request
  • Body parameters
  • Response
  • ThumbnailDownloadURL
  • ScaledURL
  1. API reference
  2. REST
  3. Thumbnail
  4. BatchGenerateDownloadURLs

Video API, REST: Thumbnail.BatchGenerateDownloadURLs

Written by
Yandex Cloud
Updated at April 24, 2025
  • HTTP request
  • Body parameters
  • Response
  • ThumbnailDownloadURL
  • ScaledURL

Generate urls for downloading images.

HTTP requestHTTP request

POST https://video.api.cloud.yandex.net/video/v1/thumbnails:batchGenerateDownloadURLs

Body parametersBody parameters

{
  "channelId": "string",
  "thumbnailIds": [
    "string"
  ]
}

Field

Description

channelId

string

Required field. ID of the channel.

thumbnailIds[]

string

List of thumbnails IDs.

ResponseResponse

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.

ThumbnailDownloadURLThumbnailDownloadURL

Field

Description

thumbnailId

string

ID of the thumbnail.

originalUrl

string

Original download url.

scaledUrls[]

ScaledURL

List of download urls, one per each available image size.

ScaledURLScaledURL

Field

Description

url

string

Download url.

maxWidth

string (int64)

Maximum width of the rectangle to inscribe the thumbnail into.

maxHeight

string (int64)

Maximum height of the rectangle to inscribe the thumbnail into.

imageFormat

enum (ImageFormat)

Image format.

  • IMAGE_FORMAT_UNSPECIFIED: Image format unspecified.
  • JPEG: JPEG image format.
  • WEBP: WebP image format.

Was the article helpful?

Previous
Create
Next
GenerateUploadURL
Yandex project
© 2025 Yandex.Cloud LLC