GetSnapshot
) is used to get a screenshot of a media file at some time point.GET /<ObjectKey>?ci-process=snapshot&time=1&format=jpg HTTP/1.1Host: <BucketName-APPID>.cos.<Region>.myqcloud.comDate: <GMT Date>Authorization: <Auth String>Content-Length: <length>
https://<BucketName-APPID>.cos.<Region>.myqcloud.com/for-test.mp4?ci-process=snapshot&time=1&format=jpg&<Auth String>
Parameter | Description | Type | Required |
ci-process | Operation type, which is fixed at snapshot. | String | Yes |
time | Screenshot time point in seconds. | float | Yes |
width | Screenshot width. Default value: 0. | Int | No |
height | Screenshot height. Default value: 0.
If width and height are both 0, the width and height of the video are used. If one of them is 0, the other value is used to automatically adapt to the aspect ratio of the video. | Int | No |
format | Screenshot format. Valid values: jpg, png. Default value: jpg. | String | No |
rotate | Image rotation method auto: Rotate automatically according to the video rotation information. off: Do not rotate. Default value:auto. | String | No |
mode | Frame capturing method keyframe: Capture the last keyframe before the specified time point. exactframe: Capture the frame at a specified time point. Default value:exactframe. | String | No |
GET /for-test.mp4?ci-process=snapshot&time=1.5 HTTP/1.1Host: examplebucket-1250000000.cos.ap-beijing.myqcloud.comDate: Fri, 10 Mar 2016 09:45:46 GMTAuthorization: q-sign-algorithm=sha1&q-ak=AKIDWtTCBYjM5OwLB9CAwA1Qb2ThTSUjfG****-sign-time=1484213027;32557109027&q-key-time=1484213027;32557109027&q-header-list=host&q-url-param-list=acl&q-signature=dcc1eb2022b79cb2a780bf062d3a40e120b40652Content-Length: 0
https://examplebucket-1250000000.cos.ap-beijing.myqcloud.com/for-test.mp4?ci-process=snapshot&time=1.5&q-sign-algorithm=sha1&q-ak=AKID********************************&q-sign-time=1650425932;1650433132&q-key-time=1650425932;1650433132&q-header-list=&q-url-param-list=&q-signature=********404b08ea7f7b8f803961bedd5
HTTP/1.1 200 OKContent-Type: image/jpegContent-Length: 266005Connection: keep-aliveDate: Fri, 10 Mar 2016 09:45:46 GMTServer: tencent-cosx-cos-request-id: NTg3NzRiMjVfYmRjMzVfMTViMl82ZGZmNw==<Image content>
Was this page helpful?