ApsaraVideo VOD displays a thumbnail for each uploaded video, which acts as a preview for the video. ApsaraVideo VOD provides multiple methods for you to change the thumbnail. After a video is uploaded, ApsaraVideo VOD takes snapshots of a few frames in the video. If you specify a snapshot as the thumbnail during the upload, the specified snapshot is set as the thumbnail. Otherwise, ApsaraVideo randomly selects one of the snapshots as the thumbnail. You can change the thumbnail after the video is uploaded.

Before you begin

  • Register an Alibaba Cloud account, complete real-name verification, and enable ApsaraVideo VOD.
  • Obtain an AccessKey pair to access ApsaraVideo VOD. You can generate an AccessKey pair for your Alibaba Cloud account on the Security Management page in the Alibaba Cloud Management Console. You can also create a RAM user in the RAM console and grant the RAM user the permissions to access ApsaraVideo VOD. For more information, see Grant permissions to a RAM user.
  • If you want to use the intelligent thumbnail feature, submit a ticket to enable the feature.
  • If a domain name is bound to a service region, you must configure a certificate for the domain name. Otherwise, skip this step. To configure the domain name certificate, see Enable HTTPS secure acceleration.

Set the thumbnail in the console

  1. Log on to the ApsaraVideo VOD console.
  2. In the left-side navigation pane, choose Media Files > Audio/Video.
  3. Find the video whose thumbnail you want to change and click Manage in the Actions column.
    Note

    After a video is uploaded, one of video snapshots is used as the video thumbnail.

    Select a video
  4. Click Editing Video Information and select one of the snapshots that are automatically taken to use as the thumbnail. You can also click Upload and select a local image to upload it as the thumbnail.
    Upload
    Note The uploaded image must be in the PNG or JPG format. The maximum size is 1 MB, and the maximum resolution is 1920 × 1080 pixels.

Set the thumbnail by using the API or SDK

ApsaraVideo VOD provides various methods to upload videos. You can specify the thumbnail when you upload a video. If you do not specify a thumbnail, ApsaraVideo VOD selects a snapshot as the thumbnail. You can call the following operations to set the thumbnail:

  • When you call the CreateUploadVideo operation, you can set the CoverURL parameter to specify the URL of the thumbnail.
  • When you call the UploadMediaByURL operation, you can set the CoverURL parameter in UploadMetadata to specify the URL of the thumbnail.
  • If a video file is stored in Object Storage Service (OSS), you can call the RegisterMedia operation to register the video file in ApsaraVideo VOD. When you call this operation, you can set the CoverURL parameter in RegisterMetadata to specify the URL of the thumbnail.
  • If the video file has been uploaded, you can set CoverURL to specify the URL of the thumbnail by calling the UpdateVideoInfo and UpdateVideoInfos operations.

Use the intelligent thumbnail feature

The intelligent thumbnail feature can analyze video content and extract multiple snapshots that best represent the video content as backup thumbnails. This feature can also extract keyframes from the video and automatically merge them into a GIF file to use as the thumbnail. To try the intelligent thumbnail feature, click MultiMedia AI. Before you use the intelligent thumbnail feature, submit a ticket to enable the feature.