个人学习小站 SIGNAL DESK 2026
LIVE --:--:--
资讯 人工智能 DeepSeek API 文档《联网工具》与官网定价公告;凤凰网科技、IT之家报道

搜索按次计费只活了 18 天:DeepSeek 联网工具怎么接、边界在哪

DeepSeek 11 月 18 日起取消模型触发场景的搜索、抓取按次计费,5 元/千次的规则只执行了 18 天。本文讲清三条接入路径、新旧成本结构对比,以及独立 Search/Fetch API 仍收费、多轮要回传 server_tool_calls 等四个边界,帮中小团队决定联网能力怎么接。

2026年11月19日 2 小时前 作者 站长 约 5 分钟 2 阅读

自北京时间 2026 年 11 月 18 日 12:00 起,DeepSeek API 调用模型时由服务端触发的联网搜索与网页抓取不再单独计费,账单只按模型 Token 用量结算。此前「每 1000 次成功请求 5 元」的按次计费,10 月 17 日随 V4.1-Flash-1017 上线、11 月 1 日正式执行,只运行了 18 天就被取消。边界要说清:独立的 Search / Fetch 接口不受影响,仍按 5 元 / 千次成功请求收费——免费的只是模型调用链路里自动触发的那部分。

对做 Chatbot、客服机器人和轻量 RAG 的中小团队来说,这次调整把「接联网能力」的固定开销直接清零:不用再按次买第三方搜索 API,也不用自己维护爬虫。下面按官方文档口径讲三条接入路径、成本怎么算,以及四个容易踩的坑。

DeepSeek 取消服务端搜索按次计费的三个关键数字:5 元变 0、按次计费执行 18 天、独立 API 仍收费

18 天里的三次变化

这次取消的不是「搜索能力」,而是它的一个计费口径。时间线如下:

时间变化说明
2026-10-17Search / Fetch API 随 V4.1-Flash-1017 上线基于 DeepSeek 自研搜索引擎,定价 5 元 / 千次成功请求
2026-11-01 00:00服务端工具调用正式按次收费DeepSeek Harness、Claude Code、Codex 内的过渡期结束
2026-11-18 12:00模型触发场景取消按次计费并入 Token 结算;独立 Search / Fetch API 定价不变

触发场景覆盖三条协议路径:联网工具、Anthropic API 的 web_search 工具、Responses API 的 web_search 工具。也就是说,只要搜索和抓取发生在模型调用的服务端链路里,账单上就不再单独列项。官方文档当前的计费口径与公告一致:服务端工具(文字搜索、图片搜索、网页抓取)不计费,只有模型 Token 用量计费。

三条接入路径:都在 tools 里声明

联网能力由两个服务端工具提供:deepseek_web_search(联网搜索与深度思考搜索)和 deepseek_read_url(阅读链接)。是否联网由模型判断,搜索和抓取都在服务端完成,客户端不需要执行任何工具。官方要求使用 deepseek-flash 模型,三种协议都能声明:

路径声明方式适合谁
Anthropic 兼容 Messages APItools 里声明两个工具,header 用 x-api-key已有 Anthropic SDK 代码、Claude Code 用户,改动最小
Chat Completions APItools 里声明,safety_check、title 放顶层OpenAI SDK 用户;注意不要传 web_search_options,会返回 400
Responses APItools 里声明,safety_check 放顶层用 Responses 协议的 Agent 框架

以 Anthropic 兼容的 Messages API 为例,官方文档的请求格式如下:

curl https://api.deepseek.com/anthropic/v1/messages \
  -H "Content-Type: application/json" \
  -H "x-api-key: ${DEEPSEEK_API_KEY}" \
  -d '{
    "model": "deepseek-flash",
    "tools": [
      {"type": "deepseek_web_search", "name": "deepseek_web_search"},
      {"type": "deepseek_read_url", "name": "deepseek_read_url"}
    ],
    "messages": [{"role": "user", "content": "今天 AI 行业有什么新发布?"}]
  }'

同一个工具,开不开思考是两种工作模式:关闭思考时是普通联网搜索,模型按需发起搜索并附引用作答,与网页端体验一致;开启思考(thinking 设为 enabled)时进入深度思考搜索,模型在多步推理里自主搜索、打开网页、页内查找(search / open_page / find_in_page),最多调用约 20 次工具后作答。研究类问题用后者,响应慢但求证更充分。

两个工具的声明不能通过 tool_choice 强制指定,写了会返回 400;tool_choice 设为 none 则关闭全部工具。

成本怎么算:省的是固定开销,Token 会涨

新旧计费口径对比:旧口径搜索抓取按次收费加 Token,新口径只看 Token,独立 Search/Fetch API 仍按次收费

按官方单价推算:一次调用若触发 1 次搜索加 1 次抓取,旧口径的固定检索开销是 0.01 元 / 次,千次调用约 10 元;新口径这部分为 0。对每天跑上万次联网调用的应用,省的是真金白银的固定成本。

但账不是单边下降的。搜索结果和抓取的正文会拼进上下文,Token 用量会涨。深度思考搜索一轮最多约 20 次工具调用,每次打开网页的内容都参与推理,输出 Token 和思考 Token(output_tokens_details.thinking_tokens)都会明显增加。省掉的按次费用,有一部分会以 Token 的形式回来。计费验证看响应里的 usage.server_tool_use:现在 tool_search、tool_fetch、tool_image_search 三个字段只统计次数、不扣费,三者全为 0 时整个字段不返回。

另外,失败请求的口径没变:搜索无结果、抓取失败不计费(这条原本是按次计费的豁免规则,现在场景里天然没有按次费用可免)。

四个容易踩的坑

  1. 独立 Search / Fetch API 仍收费,别混着算:要拿结构化 JSON 结果、自己组装检索管道的,仍要走独立接口,5 元 / 千次成功请求,且受账号级 QPS 5 限制(Search 与 Fetch 各自独立限流,互不占用)。免费的是「模型触发」,不是「搜索本身」。
  2. 多轮对话必须原样回传 server_tool_calls:阅读链接拿到的网页正文不直接返回,而是加密放在 signature 里,下一轮要靠它拼回上下文。框架或网关把这个字段丢了,请求不会报错,但之前读过的网页会静默消失——这是官方文档明确点名的集成故障点。Chat Completions 和 Responses 协议同理,回传时保留 kind 和 signature。
  3. 用过联网工具的回复不能续写:带 prefix 的继续生成会返回 400,只能重发上一次请求。做流式补全或「接着刚才说」的功能时要把这个限制设计进去。
  4. 阅读链接只看最后一条用户消息:最多识别前 10 个不同 URL,重复算一个;同一轮读多个链接时单个网页可用长度变短,长页会被截断。对外提供服务的应用记得开 safety_check,未通过审核的网页返回 url_not_allowed 错误。

该不该接:结论与边界

适合接的场景:给 Chatbot、客服机器人、问答助手加联网能力,或者轻量 RAG 里需要实时网页补充——这些场景本来就不关心搜索结果的原始结构,只要模型答得对,现在固定开销为零,接的动机比调整前充分得多。

不该指望它的场景:要把检索结果当数据用的管道——自己的 rerank、域名白名单、按站点过滤、结构化字段抽取。这些控制粒度「模型触发」的隐式搜索给不了,官方文档也明确说这类需求用独立 Search / Fetch API 自己编排。两条路径的价格差(0 与 5 元 / 千次)正好把适用场景分开了:让模型搜,免费;让程序搜,照旧付钱。

定价最近变动频繁(18 天内两次调整),接入前建议先看官网价格页核对当前口径。站内相关的两篇可以对照着看:《DeepSeek 上线额度管理:C 端用户或将面临限额》讲的是同一时期的限流动作,《同一个 DeepSeek 模型 50 个 API 端点:34 倍价差怎么选》讲端点选择。接入后如果 Token 涨得超过预期,排查思路见《Token 消耗太快怎么查:两个放大器与四步止血》。

登录后可点赞、收藏与反馈。

继续阅读 NEXT

更多 →