文档预览功能（doc-preview）可以在线预览存储在存储桶中的文档文件。本文介绍文档预览功能的参数说明及使用示例。
注意
文档预览功能目前处于邀测状态，如您需要使用该功能，请联系客户经理。
由于域名使用限制，在 2024 年 01 月 03 日之后创建的存储桶预览文件时，必须使用自定义域名。关于设置自定义域名的具体操作，请参见设置自定义域名。
说明
在 2024 年 01 月 03 日之后创建的存储桶使用默认域名以预签名或匿名方式访问文件时，TOS 会直接下载文件到本地，而非在线预览，详细介绍，请参见对象存储桶域名使用限制变更公告。
参数 | 参数说明 | 取值说明 | 是否必选 |
|---|---|---|---|
x-tos-doc-src-type | 指定预览文件的类型。 说明 当前文档转换根据 TOS 对象的后缀名来确定源数据类型。当 TOS 对象没有后缀名时，需要设置该值。 | pptx、ppt、doc、docx、xls、xlsm。 | 否 |
x-tos-doc-dst-type | 指定输出的文件格式。 说明 预览表格文件，并设置输出的文件格式为图片时，一张表格可能分割为多页进行转换，最后会生成多张图片。 | png、jpg、pdf、html。 | 否 |
x-tos-doc-page | 当输出的文件格式为图片时，需要指定文件转换的页码。 说明 当输出的文件格式为 | [1,5000] | 否 |
原文件示例：
以 JPG 的方式，预览文件的第 1 页，示例 URL 如下：
以 PDF 的方式，预览文件，示例 URL 如下：
以 HTML 的方式，预览文件，示例 URL 如下：