tencent cloud

智能媒资托管

产品简介
产品概述
功能介绍
产品优势
应用场景
基本概念
购买指南
快速入门
创建媒体库
发起请求
服务级 API 文档
History
Introduction
API Category
Making API Requests
PaaS Service APIs
Official Cloud Disk APIs
Data Types
Error Codes
业务级 API 文档
简介
访问令牌操作接口
租户空间操作接口
文件操作接口
目录或相簿操作接口
回收站操作接口
配额操作接口
查询任务操作接口
搜索操作接口
历史版本操作接口
目录和文件批量操作接口
收藏操作接口
Error Codes
SDK 文档
Android SDK
iOS SDK
鸿蒙 SDK
常见问题
企业网盘
产品简介
购买指南
快速入门
常见问题
Service Level Agreement
词汇表

获取相簿封面

PDF
聚焦模式
字号
最后更新时间: 2026-01-07 14:52:07

功能描述

用于获取相簿封面图。

接口说明

封面图获取规则:首先找到对应相簿或租户空间根据上传时间排序的首个媒体,如果为图片则使用该张图片,如果为视频则使用该视频的首帧图片,随后如果指定了 {Size} 参数,则优先使用人脸识别智能缩放裁剪为 {Size}px × {Size}px 大小,如果未识别到人脸则居中缩放裁剪为 {Size}px × {Size}px 大小,如果未指定 {Size} 参数则使用原图,最后 302 跳转到对应的图片的 URL。
可以直接在使用图片的参数中指定该 URL,例如小程序 <image> 标签、 HTML <img> 标签或小程序 wx.previewImage 接口等,该接口将自动 302 跳转到真实的图片 URL。

请求

请求示例


GET /api/v1/album/{LibraryId}/{SpaceId}/cover?size={Size}&access_token={AccessToken}&user_id={UserId}或GET /api/v1/album/{LibraryId}/{SpaceId}/cover/{AlbumName}?size={Size}&access_token={AccessToken}&user_id={UserId}
请求参数:
LibraryId:媒体库 ID,必选参数。
SpaceId:空间 ID,如果媒体库为单租户模式,则该参数固定为连字符(-);如果媒体库为多租户模式,则必须指定该参数。
AlbumName:相簿名,分相簿媒体库必须指定该参数,不分相簿媒体库不能指定该参数。
AccessToken:访问令牌,对于公有读媒体库或租户空间,可不指定该参数,否则必须指定该参数。
UserId:用户身份识别,当访问令牌对应的权限为管理员权限且申请访问令牌时的用户身份识别为空时用来临时指定用户身份,详情请参阅 生成访问令牌接口,可选参数。

请求体

该请求无请求体。

响应

响应码

获取成功,返回 HTTP 200 OK。

响应体

响应体为文件内容。

帮助和支持

本页内容是否解决了您的问题?

填写满意度调查问卷,共创更好文档体验。

文档反馈