2026 年 11 月 13 日，DeepSeek 宣布开放一套应用 API，其中包括把文件解析后送入聊天上下文的能力。开发报告问答、资料助手或文档分析工具的团队，可以通过接口处理附件，再让模型围绕内容回答。接入时首先要选好解析方式，本文说明文字、图表怎样进入上下文，以及上传、保留和反复问答各有什么成本。官方公告

报告里的文字与图表一起被读取的原创 AI 概念插画

[配图建议：报告上的文字与折线图一起进入阅读视野 + 暖白底色的写实概念插画]

先按问题选模式，图表才有机会进入回答

设想一份产品运营报告。正文写着“本季度整体增长”，图中却显示某条产品线最后一个月下滑。用户问“哪条产品线需要优先跟进”，回答需要结合文字和曲线。如果开发者在导入时只提取正文，后面的提问就缺少这部分依据。

DeepSeek 提供两个解析用途。text_recognition 提供文字内容，适合以文字为主的文档。rich_layout_recognition 会把检测到的图表、照片和示意图裁出，并按它们在文字中的原有位置交给模型。后者适合答案依赖插图的报告、幻灯片和操作手册，自动检测的覆盖情况仍需检查。文件解析指南

文件与提问 可评估的用途 需要核对的内容
扫描文字、条款或正文摘要 text_recognition 字词、数字与段落顺序
曲线趋势、流程图或设备示意 rich_layout_recognition 目标图片是否进入回答依据
纯文本、CSV 或 Excel 文件 user_data 上传后转换出的文本内容

Files API 为纯文本、表格和电子书提供 user_data 路径，其中 Excel 文件会在上传时转换为 Markdown。PDF、Word 和 PowerPoint 则使用前两种解析用途。文件格式、提问目标和用途字段应在导入前对应起来。Files API 文件解析指南

先写出需要从文件得到的答案，再决定保留哪些内容。例如，团队只想提取会议日期，可以先验证文字模式。要解释设备连接图，就应把图形理解列入验收。这样也便于发现问题来自导入、模型理解还是提问表达。

[配图建议：同一份报告中的正文、曲线图和用户问题对应起来 + 清晰的编辑式信息图]

上传完成后，用文件标识接入对话

文件输入采用“上传，再引用”的流程。应用把附件交给 Files API，成功后保存返回的 file_id，聊天请求再引用它，当前文档指定配合 deepseek-flash 使用。三种聊天协议均支持文件输入，接入时按自己采用的协议组织消息块。聊天功能总览 Files API

下面演示上传一份图表相关的报告。执行前准备好 report.pdf，在环境变量中设置自己的 API Key，应用上线时使用服务端凭据管理。

curl --fail-with-body https://api.deepseek.com/files \
  -H "Authorization: Bearer ${DEEPSEEK_API_KEY}" \
  -F purpose=rich_layout_recognition \
  -F file=@report.pdf

表单中的 purpose 放在 file 前面。取得真实文件 ID 后，可在 Chat Completions 的用户消息中加入文件块，并把问题写得可核对，例如“说明最后一张趋势图里各条曲线的变化，指出结论对应的图中文字”。返回结果先与原报告对照，再接入正式界面。文件解析指南

上传界面的状态应覆盖传输和解析两个阶段。这条链路在解析成功后返回文件标识。客户端与中间代理需要留出处理时间，连接中断后先查询文件列表，确认远端结果再决定是否重传。可以在自己的任务记录里保存文件名、提交时间和返回 ID，给用户清楚的恢复入口。文件解析指南 文件列表接口

产品里的“正在读取附件”也应有明确含义。上传尚在进行、服务正在解析、模型开始回答，可以分别展示相应状态。测试时记录各阶段完成时间，有助于确定等待发生在哪里，并设计合适的超时提示。这是应用层接入建议。

[配图建议：附件上传、解析完成、文件标识和聊天请求四步流程 + 简洁技术流程图]

把解析费、问答费和文件保留一起设计

截至本次核查，官方价格页列出的文件解析与 OCR 价格为每千页 0.225 美元。以成功解析 100 页为假设，按该单价计算，页数费用为 0.0225 美元。文档问答还涉及模型输入和输出 token 费用，预算应记录这些项目各自的实际用量。官方价格页

同一份文件上传解析成功后，再次引用会按模型输入 token 计费，裁出的图片也消耗输入 token。因此，在产品里连续追问一份长报告时，可以同时观察每轮上下文规模、回答质量和费用。先用一份长度接近实际工作的资料测完整流程，预算会更贴近真实使用。文件解析计费说明

文件保留也有明确配置。上传时可以设置 1 小时至 30 天的自动到期时间，省略到期字段则永久保留。文件归属于账号，同一账号下的 API Key 共享这些文件。多用户应用需要在自己的业务记录中维护用户与文件的对应关系，明确哪些会话能够引用哪些附件。Files API

适合先做试点的，是已有附件问答需求、希望验证服务端解析效果的团队。若业务要保存逐页识别结果、制作可复用文本资料，可以评估独立 OCR 接口，它按页返回识别结果，便于应用另行保存、索引或校对。这样能够根据交付目标选择接入路径。OCR 指南

[配图建议：页数费用、每轮 token 用量与附件到期时间并排记录 + 克制的产品设计示意图]

用一组带答案的小文件验证图文理解

验证材料可以先选三类。第一类是清楚的文字页，用来核对识别和段落。第二类是正文与图表信息互相补充的报告，用来检查回答是否使用了图中的细节。第三类是分辨率较低或布局复杂的页面，用来观察应用如何向用户表达信息缺失。

每份材料预先写好问题和人工答案。例如，一张曲线图可以检查曲线名称、横轴区间、变化方向和单位。分别提交两种解析用途，保持文件与问题一致，记录回答中哪些判断可由原页支持。由人工核对结果后，再选择项目默认模式，并保留让用户调整的入口。

如果采用独立 OCR 来建立校对流程，要同时查看逐页的 finish_reason。官方定义中，stop 表示完整识别，length 表示输出触及限制、该页文字存在缺失。把这种状态纳入验收，有助于避免在资料尚不完整时继续生成摘要。OCR 接口字段定义

验收单位应是一份附件和一组可核对的问题。记录识别是否完整、目标图片是否被正确使用、答案是否忠于原件，以及总耗时和费用。对中文缩写、图例颜色、跨页表格等实际业务特征，单独保留失败样本，后续再检查配置或处理方式。

[配图建议：原始页面、人工问题答案和模型回答逐项对照 + 清晰的文档校对工作台插画]

今天先找一张答案藏在图里的报告页

今天可以拿一份允许用于测试的短报告，选出一个依赖图表才能回答的问题，分别验证文字与图文布局模式。已有文件问答产品的团队可以优先检查导入配置，正在评估的团队则先用这一小组材料确定效果、等待时间和完整费用，再决定接入范围。

你最常遇到的是 AI 漏读图表、认错数字，还是找不到结论对应的原文？这些失败样本能帮助确定第一轮验收重点。

资料核查时间为北京时间 2026 年 11 月 15 日。本文依据官方公告与接口文档进行核查，代码为接入示例，报告场景和验收建议用于说明应用方法，封面为原创 AI 概念插画。

[配图建议：一张报告页上的问题与对应图表被准确标记 + 留白充足的写实技术笔记插画]