文档中心

对象存储

请输入

文档预览

文档预览概述

TOS 支持以图片、PDF、HTML 的格式预览存储桶的文档文件。本文介绍文档预览的计费说明、使用限制以及使用方式等。

说明

文档预览功能处于邀测状态，如需使用，请联系客户经理。

计费说明

预览文档时，TOS 支持以图片、PDF、HTML 的格式展示文档文件。不同的格式，计费方式不同，说明如下：

操作
说明
参考文档
文档转图片或 PDF
按照预览时图片的页数进行收费。
数据处理费用
文档转 HTML
按照预览的次数进行收费。

对低频存储、归档闪回存储类型的文件使用文档预览功能时，会产生数据取回费用，按照预览的文件大小进行收费。

使用限制

类别	使用限制
文件类型	仅支持预览以下文件类型：演示文件：pptx、ppt。文字文件：docx、doc。表格文件：xlsx、xls。其他格式文件：pdf。
输出格式	仅支持输出 png、jpg、pdf、html 的文件格式。注意出于安全合规考虑，从 2022 年 10 月 18 日开始，如果您使用存储桶的默认域名访问网页类型文件（mimetype为 text/html，扩展名包括 HTM、HTML、JSP、PLG、HTX、STM），Response Header 中会自动加上 Content-Disposition:attachment，即从浏览器访问网页类型文件时，将不会直接预览网站，而会将网站的内容下载到本地。
文件大小	预览的文件大小不能超过 200MB 。
表格文件	以图片的方式预览表格文件时，一张表格可能分割为多页进行转换，生成多张图片。
服务端加密	支持对使用 SSE-TOS、SSE-C、SSE-KMS 加密的文档进行预览，使用限制如下：对使用 SSE-C 加密的文档进行预览时，必须携带 SSE-C 的如下头域，关于 SSE-C 头域的详细介绍，请参见使用用户提供密钥的服务端加密（SSE-C）。 x-tos-server-side-encryption-customer-algorithm x-tos-server-side-encryption-customer-key x-tos-server-side-encryption-customer-key-MD5 不支持匿名预览经过 SSE-KMS 加密的文档，您必须开通 KMS 服务，具备访问主密钥的权限，才能使用有效签名预览经过 SSE-KMS 加密的文档。您可以使用预签名、API 预览经过 SSE-KMS 加密的文档，详细介绍，请参见下文的使用 REST API。

文档预览方式

文档预览目前提供 REST API、文件 URL 两种使用方式。您可以对存储在存储桶中的文档以图片、PDF 或 HTML 方式进行预览。

说明

处理后的文件会即时返回，不会保存到您的存储桶中。

使用 REST API，请求示例如下：

GET /example.docx?x-tos-process=doc-preview&x-tos-doc-src-type=docx&x-tos-doc-dst-type=jpg&x-tos-doc-page=1 HTTP/1.1
Host: endpoint
X-Tos-Content-Sha256: sha256
X-Tos-Date: 20220827T132948Z
Authorization: authorization

使用文件 URL

http://bucket.endpoint/example.docx?x-tos-process=doc-preview&x-tos-doc-src-type=docx&x-tos-doc-dst-type=jpg&x-tos-doc-page=1

说明

对于私有文件，需要使用 SDK 生成带文档预览参数的预签名 URL 进行操作。

文档预览功能

文档预览功能	参数	说明
文档预览	doc-preview	以图片、PDF 或 HTML 的方式预览存储桶的文档文件。

最近更新时间：2026.08.10 17:37:52

这个页面对您有帮助吗？

有用

无用

操作	说明	参考文档
文档转图片或 PDF	按照预览时图片的页数进行收费。	数据处理费用
文档转 HTML	按照预览的次数进行收费。	数据处理费用