对象存储

动态与公告

产品简介

购买指南

快速入门

控制台指南

工具指南

最佳实践

视频教程专区

开发者指南

数据湖存储

数据处理 Demo 体验

故障处理

API 文档

SDK 文档

常见问题

服务等级协议

附录

联系我们

词汇表
文档捉虫大赛火热进行中，好礼多多> HOT
文档中心 > 对象存储 > API 文档 > 数据处理接口 > 媒体处理 > 同步媒体处理 > 媒体截图接口 > 获取媒体文件截图（万象域名）

获取媒体文件截图（万象域名）

最近更新时间：2022-05-06 14:13:42

前往 GitHub 编辑 我的收藏

本页目录：

功能描述

GenerateSnapshot 接口用于获取媒体文件某个时间的截图，输出的截图统一为 jpeg 格式。

请求

请求示例

POST /snapshot HTTP/1.1
Host: <BucketName-APPID>.ci.<Region>.myqcloud.com
Date: <GMT Date>
Authorization: <Auth String>
Content-Length: <length>
Content-type: application/xml

<body>

说明：

Authorization: Auth String（详情请参见 请求签名 文档）。

请求头

此接口仅使用公共请求头部，详情请参见 公共请求头部 文档。

请求体

该 API 接口请求的请求体具体节点内容为：

<Request>
  <Input>
    <Object></Object>
  </Input>
  <Time></Time>
  <Width></Width>
  <Height></Height>
  <Mode></Mode>
  <Rotate></Rotate>
  <Format></Format>
  <Output>
    <Region></Region>
    <Bucket></Bucket>
    <Object></Object>
  </Output>
</Request>

具体的数据内容如下：

节点名称（关键字） 父节点 描述 类型 是否必选
Request 无 保存 Generate Snapshot 请求的容器 Container 是

Container 节点 Request 的内容：

节点名称（关键字） 父节点 描述 类型 是否必选
Input Request 媒体文件的位置信息 Container 是
Time Request 截取哪个时间点的内容，单位为秒 Float 是
Output Request 截图保存的位置信息 Container 是
Width Request 截图的宽。默认为0 Int 否
Height Request 截图的高。默认为0。
Width 和 Height 都为0时，表示使用视频的宽高。如果单个为0，则以另外一个值按视频宽高比例自动适应。		 Int 否
Format Request 截图的格式，支持 jpg 和 png，默认 jpg String 否
Mode Request 截帧方式：
  • keyframe：截取指定时间点之前的最近的一个关键帧
  • exactframe：截取指定时间点的帧
    • 默认值为 exactframe    		 String 否
    Rotate Request 图片旋转方式：
  • auto：按视频旋转信息进行自动旋转
  • off：不旋转
    默认值为 auto
    		•  String 否

    Container 节点 Input 的内容：

    节点名称（关键字） 父节点 描述 类型 是否必选
    Object Request.Input 文件的名称 String 是

    Container 节点 Output 的内容：

    节点名称（关键字） 父节点 描述 类型 是否必选
    Region Request.Output 存储桶所在的地域 String 是
    Bucket Request.Output 文件所属的 COS 存储桶 String 是
    Object Request.Output 文件的名称 String 是

    响应

    响应头

    此接口仅返回公共响应头部，详情请参见 公共响应头部 文档。

    响应体

    该响应体返回为 application/xml 数据，包含完整节点数据的内容展示如下：

    <Response>
  <Output>
    <Region></Region>
    <Bucket></Bucket>
    <Object></Object>
  </Output>
</Response>

    具体的数据内容如下：

    节点名称（关键字） 父节点 描述 类型
    Response 无 保存结果的容器 Container

    Container 节点 Response 的内容：

    节点名称（关键字） 父节点 描述 类型
    Output Request 截图保存的位置信息 Container

    Container 节点 Output 的内容：

    节点名称（关键字） 父节点 描述 类型
    Region Response.Output 存储桶所在的地域 String
    Bucket Response.Output 文件所属的 COS 存储桶 String
    Object Response.Output 文件的名称 String

    错误码

    该请求操作无特殊错误信息，常见的错误信息请参见 错误码 文档。

    实际案例

    请求

    POST /snapshot HTTP/1.1
Host: examplebucket-1250000000.ci.ap-beijing.myqcloud.com
Date: Fri, 10 Mar 2016 09:45:46 GMT
Authorization: q-sign-algorithm=sha1&q-ak=AKIDWtTCBYjM5OwLB9CAwA1Qb2ThTSUj****&q-sign-time=1484213027;32557109027&q-key-time=1484213027;32557109027&q-header-list=host&q-url-param-list=acl&q-signature=dcc1eb2022b79cb2a780bf062d3a40e120b4****
Content-Length: 552
Content-Type: application/xml

<Request>
  <Input>
    <Object>video-for-test.mp4</Object>
  </Input>
  <Time>10</Time>
  <Output>
    <Region>ap-beijing</Region>
    <Bucket>ci-output-1250000000</Bucket>
    <Object>snapshot/video-for-test-snapshot.jpg</Object>
  </Output>
</Request>

    响应

    HTTP/1.1 200 OK
Content-Type: application/xml
Content-Length: 266
Connection: keep-alive
Date: Fri, 10 Mar 2016 09:45:46 GMT
Server: tencent-ci
x-ci-request-id: NTg3NzRiMjVfYmRjMzVfMTViMl82ZGZm****

<Response>
  <Output>
    <Region>ap-beijing</Region>
    <Bucket>ci-output-1250000000</Bucket>
    <Object>snapshot/video-for-test-snapshot.jpg</Object>
  </Output>
</Response>

    目录