文档中心

对象存储

文档预览

文档预览

文档预览

文档预览功能（doc-preview）可以在线预览存储在存储桶中的文档文件。本文介绍文档预览功能的参数说明及使用示例。

注意事项

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

由于域名使用限制，在 2024 年 01 月 03 日之后创建的存储桶预览文件时，必须使用自定义域名。关于设置自定义域名的具体操作，请参见设置自定义域名。

说明

在 2024 年 01 月 03 日之后创建的存储桶使用默认域名以预签名或匿名方式访问文件时，TOS 会直接下载文件到本地，而非在线预览，详细介绍，请参见对象存储桶域名使用限制变更公告。

参数说明

请求参数

参数	参数说明	取值说明	是否必选
x-tos-doc-src-type	指定预览文件的类型。说明当前文档转换根据 TOS 对象的后缀名来确定源数据类型。当 TOS 对象没有后缀名时，需要设置该值。	pptx、ppt、doc、docx、xls、xlsx、pdf。	否
x-tos-doc-dst-type	指定输出的文件格式。说明预览表格文件，并设置输出的文件格式为图片时，一张表格可能分割为多页进行转换，最后会生成多张图片。	png、jpg、pdf、html。默认为 jpg。	否
x-tos-doc-page	当输出的文件格式为图片时，需要指定文件转换的页码。说明当输出的文件格式为 pdf 或 html 时，无法选择页码，page 参数不生效。	[1,5000] 默认为 1。	否
x-tos-doc-image-dpi	按指定 dpi 渲染图片，输出格式为 png，jpg 时生效。调低该参数会降低处理时间，调高该参数会增加处理时间。	[96-600] 默认值为 300 。	否
x-tos-doc-image-quality	转码后的图片质量。例如取值为 90，代表生成图片质量为 90%。	[1, 100] 默认值 90。	否

响应参数

参数	参数说明	取值说明
content-type	根据图片实际的格式，返回不同的值。	image/jpeg、image/png、application/pdf、text/html。
x-tos-total-page	返回文档总页数（表格文件表示当前 sheet 转换后的总图片数）。	-

示例

原文件示例：

演示文件：https://tos-tools.tos-cn-beijing.volces.com/misc/example.pptx

文字文件：https://tos-tools.tos-cn-beijing.volces.com/misc/example.docx

表格文件：https://tos-tools.tos-cn-beijing.volces.com/misc/example.xlsx

以 JPG 的方式，预览文件的第 1 页，示例 URL 如下：

演示文件：https://tos-tools.tos-cn-beijing.volces.com/misc/example.pptx?x-tos-process=doc-preview&x-tos-doc-dst-type=jpg&x-tos-doc-page=1

文字文件：https://tos-tools.tos-cn-beijing.volces.com/misc/example.docx?x-tos-process=doc-preview&x-tos-doc-dst-type=jpg&x-tos-doc-page=1

表格文件：https://tos-tools.tos-cn-beijing.volces.com/misc/example.xlsx?x-tos-process=doc-preview&x-tos-doc-dst-type=jpg&x-tos-doc-page=1

以 PDF 的方式，预览文件，示例 URL 如下：

演示文件：https://tos-tools.tos-cn-beijing.volces.com/misc/example.pptx?x-tos-process=doc-preview&x-tos-doc-dst-type=pdf

文字文件：https://tos-tools.tos-cn-beijing.volces.com/misc/example.docx?x-tos-process=doc-preview&x-tos-doc-dst-type=pdf

表格文件：https://tos-tools.tos-cn-beijing.volces.com/misc/example.xlsx?x-tos-process=doc-preview&x-tos-doc-dst-type=pdf

以 HTML 的方式，预览文件，示例 URL 如下：

演示文件：https://tos-tools.tos-cn-beijing.volces.com/misc/example.pptx?x-tos-process=doc-preview&x-tos-doc-dst-type=html

文字文件：https://tos-tools.tos-cn-beijing.volces.com/misc/example.docx?x-tos-process=doc-preview&x-tos-doc-dst-type=html

表格文件：https://tos-tools.tos-cn-beijing.volces.com/misc/example.xlsx?x-tos-process=doc-preview&x-tos-doc-dst-type=html

最近更新时间：2026.08.03 11:28:39

这个页面对您有帮助吗？

有用

有用

无用

无用