tencent cloud

文档反馈

媒体截图接口

最后更新时间:2024-03-13 11:32:21

    简介

    本文档提供关于媒体截图接口的 API 概览和 SDK 示例代码。
    注意:
    需要 COS PYTHON SDK v5.1.9.11 及以上版本。
    API
    操作名
    操作描述
    查询截图
    用于查询媒体文件在某个时间的截图
    注意:
    使用此接口前,请确保已打开官网控制台中数据处理下的媒体处理开关,否则会报错media bucket unbinded, bucket's host is unavailable。详情请参见 开通媒体处理

    查询截图

    功能说明

    用于查询媒体文件在某个时间的截图。

    方法原型

    def get_snapshot(Bucket, Key, Time, Width=None, Height=None, Format='jpg', Rotate='auto', Mode='exactframe', **kwargs)

    请求示例

    response = client.get_snapshot(
    Bucket='examplebucket-1250000000',
    Key='demo.mp4',
    Time='1.5',
    Width='480',
    Format='png'
    )
    print(response)
    response['Body'].get_stream_to_file('snapshot.jpg')

    参数说明

    参数名称
    参数描述
    是否必填
    类型
    Bucket
    存储桶名称,格式为 BucketName-APPID ,详情请参见 命名规范
    String
    Key
    对象键(Key)是对象在存储桶中的唯一标识
    String
    Time
    截图的时间点,单位为秒,可以支持小数点
    String
    Width
    截图的宽。默认为0
    String
    Height
    截图的高。默认为0 当 width 和 height 都为0时,表示使用视频的宽高;如果单个为0,则以另外一个值按视频宽高比例自动适应
    String
    Format
    截图的格式,支持 jpg 和 png,默认 jpg
    String
    Rotate
    图片旋转方式 auto:按视频旋转信息进行自动旋转off:不旋转,默认值为 auto
    String
    Mode
    截帧方式 keyframe:截取指定时间点之前的最近的一个关键帧exactframe:截取指定时间点的帧,默认值为 exactframe
    String
    联系我们

    联系我们,为您的业务提供专属服务。

    技术支持

    如果你想寻求进一步的帮助,通过工单与我们进行联络。我们提供7x24的工单服务。

    7x24 电话支持