DeepSeekChatbot内容安全文件解析Nbility

用 DeepSeek 新接口做对外聊天机器人,拒答要在前端处理

DeepSeek 11 月 13 日开放联网搜索、文件输入、阅读链接和模型安全参数。对外提供服务时,流式回答可能在结束后被判拒答;本文说明三种协议的拒答标记、计费与文件解析的超时设置。

查看接入文档
用 DeepSeek 新接口做对外聊天机器人,拒答要在前端处理

2026 年 11 月 13 日,DeepSeek 把网页端和 App 里的几项对话能力开放给 API:联网搜索、深度思考搜索、文件输入、阅读链接和模型内容安全。deepseek-flash 在 Messages、Responses 和 Chat Completions 三种协议下都能使用,搜索和抓网页由服务端完成。

想用它做一个面向公众的聊天机器人时,最容易漏掉的是这一点:开启安全校验后,回答已经流式显示给用户,仍可能在最后被判为拒答。 前端需要能撤下已显示的内容。

本文于 2026 年 11 月 15 日核对 DeepSeek 的更新日志、构建 Chatbot、模型内容安全、文件解析和价格文档。没有用真实 Key 调用,没有触发拒答,文中的响应格式来自官方文档。下面讲的是 DeepSeek 官方 API;若经由网关转发,需另行确认 safety_check 等字段是否原样透传。

开启安全校验只要一个字段

{"safety_check": {"level": "high"}}

level 只能是 high 或 low,low 等于不传,是 API 默认的内容检查。开启后会审核用户消息、tool_result 等输入和模型输出。可以单独使用,也可以和联网工具一起用;单独使用时 tool_choice 只能是 auto 或 none。

DeepSeek 文档写得很直接:对外提供服务时请开启这个参数,但它不能替代服务提供者自己的内容安全审核、大模型登记、AI 标识等义务。开发者仍是内容安全的第一责任人。

拒答发生在流式结束之后

开启 safety_check 后,模型输出结束时连接不会马上关闭,服务端还会对完整输出再审核一次。审核期间连接保持打开,审核结果仍可能把这次响应改为拒答。

已经流式发给浏览器的文字无法撤回。所以前端要做到:

  1. 边收边显示,但把这段回答标为“待确认”。
  2. 收到结束标记后再判断是否拒答。
  3. 如果是拒答,删掉已显示的回答,换成你自己的提示文案;响应不会说明具体原因。
  4. 历史记录里也不要保留被撤下的内容。

先显示、再最终审核、拒答时整段替换

三种协议的拒答标记不同,处理代码要按协议分别判断:

协议拒答时已执行的工具
Messagesstop_reason 为 refusal保留工具块,补一个空 text 块
Responsesstatus 为 incomplete,incomplete_details.reason 为 content_filteroutput 只保留 web_search_call
Chat Completionsfinish_reason 为 content_filter,content 为空字符串保留 server_tool_calls,思考被清空

Chat Completions 的拒答看起来像“返回了空内容”。如果你的客户端把空 content 当成网络错误自动重试,会重复付费又得到同样结果;先看 finish_reason,排查方法见AI API 返回空内容。图片未通过审核时,说明会放在 refusal 字段里,指出是哪几张。

另外两点:没有开启 safety_check 但声明了联网工具的请求,也可能以拒答结束;若是输入未通过审核,请求直接返回 400 Content Exists Risk。

三种协议的拒答结束方式

拒答也会计费

按文档:

  • 拒答前已经消耗的 Token 照常计费。
  • 安全审核本身产生的 Token 按输出计费,单独列在 usage 的 safety_tokens(Chat Completions 为 usage.completion_tokens_details.safety_tokens)。
  • 输入未通过审核返回 400 时,输入 Token 仍按缓存命中价计费。

deepseek-flash 当前价格分时段:工作日北京时间 9:00–12:00、14:00–18:00 为高峰,输入(未命中缓存)每百万 Token 2 元、输出 8 元;其他时段减半。联网搜索和网页抓取另按每 1,000 次 5 元计费。记账时把 safety_tokens 与普通输出分开记录,月底才看得出审核带来多少额外支出。

开启联网工具、safety_check: high 或会话标题时,temperature、top_p、stop、seed、n 等参数会被服务端忽略(各协议列表不同)。max_tokens 仍有效,但限制的是每一步推理的输出,不是整轮总输出。

文件上传要等解析完成

文件输入分两步:先上传到 Files API 并指定解析方式,拿到 file_id 后在对话里引用。

curl https://api.deepseek.com/files \
  -H "Authorization: Bearer $DEEPSEEK_API_KEY" \
  -F purpose="text_recognition" \
  -F file="@report.pdf"

几个会影响实现的细节:

  • purpose 必须写在 file 前面,否则返回 400。OpenAI Python SDK 默认先发表单字段,无需处理。
  • 上传接口会等解析完成才返回,期间不发送任何数据。上传限时 120 秒,解析限时 120 秒;客户端和中间代理的超时要按两者之和设置。
  • 客户端断开不会取消解析。 解析成功的文件照常保存并按页计费(每 1,000 页 1.5 元),之后可在 GET /files 里找到,不要盲目重新上传。
  • text_recognition 只给文字,图表会被丢弃;需要模型看图时用 rich_layout_recognition,裁出的图会占输入 Token 和每请求图片数上限。
  • 引用后的文档会一直在上下文里。 多轮对话中历史消息引用的文档内容完整保留,每一轮都按输入计费;超长时返回 400,不会静默截断。每请求最多 20 个文档、文字合计 8 MiB。

上传时等解析、拿到 file_id、每轮引用都计输入

上传、两种解析方式和读链接的完整流程,见DeepSeek API 现在能直接读文件和网页吗。原始文件和解析结果都不支持下载,你自己的系统需要保留原件。纯文本、表格和电子书用 purpose: user_data 上传,不计解析费。需要回答带出处时,引用如何对上原文可参考PDF 问答的引用链;只做搜索与抓取研究,见DeepSeek Search & Fetch。

演示客户端不能直接上线

DeepSeek 开源了一个演示客户端,API Key、历史对话和图片都存在浏览器本地,官方说明“仅供演示”。对外服务时,Key 要放在你自己的后端,由后端转发请求、记录用量并处理拒答,不要把 Key 交给访客的浏览器,原因见API Key 安全保存。

上线前可以用这份清单自查:

  • 前端能在收到拒答标记后撤下整段回答,并替换为提示。
  • 空 content 不会触发自动重试。
  • 日志区分 safety_tokens、搜索次数和文件解析页数。
  • 上传请求的超时至少覆盖 240 秒(上传加解析)。
  • 登记、AI 标识等合规义务由你的团队另行完成。

相关文章

用 Nbility 跑通你的 Agent 工作流

获取 API Key,统一接入 OpenAI 兼容模型和开发工具。

获取 API Key