功能描述
文档智能预览在传统文档 HTML 预览功能（支持 PPT、Word、Excel、PDF 等多种常见文档格式）的基础上，新增基于 DeepSeek 深度思考大模型的 AI 文档阅读助手，您可在预览文档时直接提问，例如“输出文档大纲”、“提取关键数据表格”等，AI 助手将快速帮助您分析文档。
说明：
授权说明
服务开通
使用该功能需提前开通数据万象，并 绑定存储桶。
使用限制
文档预览部分限制与文档转 HTML 相同，详情请参见 文档预览限制。
AI 助手问答限制如下：
支持的格式：pdf、pptx、docx、csv、xlsx。
支持进行 AI 分析的文档大小：50MB。
支持进行 AI 分析的文档字数限制：2万字。
AI 问答并发限制（QPS）：3。
地域限制：南京。
费用说明
文档智能预览的 AI 阅读助手当前处于内测阶段，不会产生费用。
预览区域将按照文档转 HTML 为付费功能，调用接口会产生 文档转 HTML 费用 和 流量费用，产生的费用将由数据万象收取。
请求
请求示例
GET /<ObjectKey>?ci-process=doc-preview&dstType=html&AIModel=deepseek-r1 HTTP/1.1Host: <BucketName-APPID>.cos.<Region>.myqcloud.comDate: GMT DateAuthorization: Auth String
请求头
请求参数
名称 | 描述 | 类型 | 是否必选 |
ObjectKey | 对象文件名，例如 folder/document.pdf | String | 是 |
ci-process | 用于指定使用哪种数据万象处理能力，文档智能预览固定为：doc-preview | String | 是 |
dstType | 输出目标文件类型，固定为 html（需为小写字母） | String | 是 |
AIModel | 用于指定AI模型，当前仅支持：deepseek-r1 | String | 是 |
注意：
为了避免未授权人员通过访问不携带处理参数的链接实现访问和滥用 AI 阅读助手的情况，即使公有读的文档，您也必须携带签名进行访问，且需要将处理参数签入到请求签名中，处理参数整体是参数的 key，value 为空，详细计算方法请参见 请求签名。
请求体
该请求的请求体为空。
响应
响应头
响应体
错误码
实际案例
将存储桶 examples-1250000000中的 ObjectKey 为 test.pptx 的 PPT 文件进行智能预览，最终 URL 如下：
https://examples-1258125638.cos.ap-guangzhou.myqcloud.com/test.pptx?ci-process=doc-preview&dstType=html&AIModel=deepseek-r1&q-sign-algorithm=sha1&q-ak=AK******qQCn&q-sign-time=1740497312;1772033312&q-key-time=1740497312;1772033312&q-header-list=host&q-url-param-list=aimodel;ci-process;dsttype&q-signature=4cd337******32
直接在浏览器中打开链接，生成的预览页面如下图所示：
