产品简介

产品概述

功能介绍

产品优势

应用场景

基本概念

购买指南

快速入门

创建媒体库

发起请求

服务级 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:27:58

功能描述 
用于预览回收站项目。
说明：
可用于预览文档、图片、视频等多种文件类型。
预览文档类型的文件时，返回 HTML 或 JPG 格式的文档用于预览。
预览视频文件时，返回视频的首帧图片作为视频封面预览。
针对照片或视频封面，优先使用人脸识别智能缩放裁剪为 {Size}px × {Size}px 大小，如果未识别到人脸则居中缩放裁剪为 {Size}px × {Size}px 大小，如果未指定 {Size} 参数则使用照片或视频封面原图，最后302跳转到对应的图片的 URL。
可以直接在使用图片的参数中指定该 URL，例如小程序 <image> 标签、 HTML <img> 标签或小程序 wx.previewImage 接口等，该接口将自动302跳转到真实的图片 URL。
如果文件不属于可预览的文件类型，则会跳转至文件的下载链接。
请求
请求示例
GET /api/v1/recycled/{LibraryId}/{SpaceId}/{RecycledItemId}?preview&type={Type}&size={Size}&scale={Scale}&width_size={WidthSize}&height_size={HeightSize}&frame_number={FrameNumber}&access_token={AccessToken}
请求参数
请求参数
描述
类型
是否必选
LibraryId
媒体库 ID，在媒体托管控制台创建媒体库后获取，请参见 创建媒体库﻿
String
是
SpaceId
空间 ID，如果媒体库为单租户模式，则该参数固定为连字符(`-`)；如果媒体库为多租户模式，则为具体 ID，获取请参见 创建租户空间﻿
String
是
RecycledItemId
回收站项目 ID，获取请参见 列出回收站项目﻿
String
是
Type
文档类型文件的预览方式，如果设置为"pic"则以 JPG 格式预览文档首页，否则以 HTML 格式预览文档
String
否
Size
图片或视频封面的缩放大小，相关说明参阅接口说明
String
否
Scale
图片或视频封面的等比例缩放百分比，不传 Size 时生效
String
否
WidthSize
图片或视频封面的缩放宽度，不传高度时，高度按等比例缩放，不传 Size 和 Scale 时生效
String
否
HeightSize
图片或视频封面的缩放高度，不传宽度时，宽度按等比例缩放，不传 Size 和 Scale 时生效
String
否
FrameNumber
GIF 文件的帧数，针对 GIF 的降帧处理，仅在预览 GIF 类型文件时生效
String
否
AccessToken
访问令牌，对于公有读媒体库或租户空间，可不指定该参数，否则必须指定该参数获取请参见 生成访问令牌﻿
String
否
请求体
该请求无请求体。
响应
响应码
获取成功，返回 HTTP 302 Found，响应头 Location 包含可直接用于展示或下载的文件 URL。
响应体
该响应无响应体。
错误码
该请求操作无特殊错误信息，常见的错误信息请参见 错误码 文档。

帮助和支持

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

您也可以联系销售或提交工单以寻求帮助。

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

文档反馈

tencent cloud

智能媒资托管

预览回收站项目

功能描述

请求

请求示例

请求参数

请求体

响应

响应码

响应体

错误码

帮助和支持

请求参数	描述	类型	是否必选
LibraryId	媒体库 ID，在媒体托管控制台创建媒体库后获取，请参见创建媒体库	String	是
SpaceId	空间 ID，如果媒体库为单租户模式，则该参数固定为连字符(`-`)；如果媒体库为多租户模式，则为具体 ID，获取请参见创建租户空间	String	是
RecycledItemId	回收站项目 ID，获取请参见列出回收站项目	String	是
Type	文档类型文件的预览方式，如果设置为"pic"则以 JPG 格式预览文档首页，否则以 HTML 格式预览文档	String	否
Size	图片或视频封面的缩放大小，相关说明参阅接口说明	String	否
Scale	图片或视频封面的等比例缩放百分比，不传 Size 时生效	String	否
WidthSize	图片或视频封面的缩放宽度，不传高度时，高度按等比例缩放，不传 Size 和 Scale 时生效	String	否
HeightSize	图片或视频封面的缩放高度，不传宽度时，宽度按等比例缩放，不传 Size 和 Scale 时生效	String	否
FrameNumber	GIF 文件的帧数，针对 GIF 的降帧处理，仅在预览 GIF 类型文件时生效	String	否
AccessToken	访问令牌，对于公有读媒体库或租户空间，可不指定该参数，否则必须指定该参数获取请参见生成访问令牌	String	否