Updates the thumbnail of a media file.

Usage notes

You can call this operation to update only the thumbnail of a media file. For more information about how to update all the information about a media file, see UpdateMedia.

Limits on QPS

You can call this operation up to 100 times per second. If the number of calls per second exceeds the limit, throttling is triggered. As a result, your business may be affected. We recommend that you take note of the limit when you call this operation. For more information, see QPS limits.


OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer. OpenAPI Explorer dynamically generates the sample code of the operation for different SDKs.

Request parameters

Parameter Type Required Example Description
Action String Yes UpdateMediaCover

The operation that you want to perform. Set the value to UpdateMediaCover.

MediaId String Yes 6cc3aa66d1cb4bb2adf14e726c0a****

The ID of the media file whose thumbnail you want to update. To obtain the ID of a media file, you can call the AddMedia operation. Alternatively, perform the following operations in the ApsaraVideo Media Processing (MPS) console: In the left-side navigation pane, choose Media Management > Media List. Find the required video and click Manage. The ID of the video is displayed on the Basics tab.

CoverURL String No http://example-bucket-****.oss-cn-hangzhou.aliyuncs.com//example-****.mp4

The URL of the thumbnail that you want to specify for the media file. The URL complies with RFC 2396 and is encoded in UTF-8. The URL can be up to 3,200 bytes in length.

Note To obtain the thumbnail URL, you can find the image in the Object Storage Service (OSS) bucket and click the image to view details. In the View Details panel, copy the part before the question mark (?) from the URL field. You can enter only an HTTP URL.

Response parameters

Parameter Type Example Description
RequestId String 0DC39B9E-13D4-40BA-AE76-CFF9BD64239D

The ID of the request.


Sample requests

&<Common request parameters>

Sample success responses

XML format

HTTP/1.1 200 OK


JSON format

HTTP/1.1 200 OK

  "RequestId" : "0DC39B9E-13D4-40BA-AE76-CFF9BD64239D"

Error codes

For a list of error codes, visit the API Error Center.