DeepSeek 开放自研 Search 与 Fetch API：每千次成功请求 5 元

DeepSeek 在 2026 年 10 月 17 日的更新公告中，把支撑自家网页端与 API 搜索的自研引擎开放成两个独立接口：Search（POST /v1/tools/search）负责检索，Fetch（POST /v1/tools/fetch）把指定网页转成 Markdown。英文公告标价「每个接口每 1,000 次调用 0.75 美元」，中文公告写「两个接口价格均为 5 元 / 千次」，两边都只对返回 HTTP 200 且真正产出结果的请求计费。

要点

• DeepSeek 的 Search 与 Fetch 按成功请求计费：Search 的 results 非空、Fetch 返回网页正文才算一次；失败、空结果、超时不计费，count 不影响单价。
• 两个接口的账号级限速各为 5 QPS，Search 与 Fetch 独立计额度，与用哪个 API Key、模型并发限制都无关，超限返回 HTTP 429。
• 免费窗口有确切终点：经 DeepSeek Harness、Claude Code、Codex 的服务端工具调用目前不计费，北京时间 2026-11-01 00:00（10-31 16:00 UTC）起按次收费。

背景

DeepSeek 的搜索能力此前只存在于自家产品里。中文公告称，网页端与 API 端的搜索长期由自研 DeepSeek 搜索引擎提供底层支持，每天处理来自全球的数亿次搜索请求，索引了千亿级网页。这些是厂商口径，公告没有给出第三方核验或分地区数据。

这次开放与同日的模型更新共用一个公告页。该页发布了 V4.1-Flash-1017 的基准说法和 Hugging Face、ModelScope 权重下载链接；模型卡本身在 Hugging Face，我们昨天那条里提到的 API 别名 deepseek-flash 来自 IT之家的报道，不在这个页面上。Search 与 Fetch 是另一条产品线，有自己的价格、配额和计费规则，两者不应混为一谈。

对做 Agent 的团队来说，检索层过去通常向外采购：自己写爬虫，或接 Brave、Exa、Tavily 这类搜索 API。模型厂商把索引收进自家 API 后，检索的账单、限速和失败处理都落到同一个账号体系里，这是这次公告的实际变化。

事实部分

DeepSeek 官方文档给出的价格、计费和限速如下（截至 2026-10-17）。中文文档与英文文档按币种分别标价，两个数字不是同一价格的换算结果：

项目	中文文档	英文文档
Search	5 元 / 1,000 次成功请求	0.75 美元 / 1,000 次成功请求
Fetch	5 元 / 1,000 次成功请求	0.75 美元 / 1,000 次成功请求
Search 计费条件	HTTP 200 且 results 非空	HTTP 200 且 results 非空
Fetch 计费条件	HTTP 200 且返回网页正文	HTTP 200 且返回网页正文
失败、空结果、超时	不计费	不计费
账号级限速	各 5 QPS，互不占用	各 5 QPS，互不占用
服务端工具调用	2026-11-01 00:00（北京时间）起收费	2026-10-31 16:00 UTC 起收费

按中文价目折算，单次成功请求约半分钱；按英文价目，100 万次成功检索是 750 美元。计费只看是否成功产出，不看 token，也不看返回多少条结果。把 count 从 5 调到 50，单次价格不变。

免费期的范围只覆盖一部分人。官方说的是「在 DeepSeek Harness、Claude Code、Codex 中经 Server 端工具调用产生的 Search/Fetch 调用」目前不计费，这几个客户端的所有用户并不都在内。Startup Fortune 在报道里也专门点出这一区别：只有把上述工具接到 DeepSeek API 上的用户才在免费范围内。

接口规则

DeepSeek 的 Search 与 Fetch 都是只读的 POST 请求，用 DeepSeek API Key 鉴权。Search 的 query 限 1–128 个字符，count 默认 10、范围 1–50，need_content 为 false 时 content 字段恒为空；另有 ori_question 用于传入原始问题、localization 用于按 IP 本地化结果。Fetch 只接收一个 url，最长 8,192 字符，必须是带主机名的 HTTP/HTTPS 地址，且不能包含用户名和密码。

Search 支持 8 个查询操作符：site:、-site:、-关键词、-"短语"、"短语"、lang:、after:、before:。对需要限定来源或时间窗的检索，这些可以直接写进 query，不必在客户端二次过滤。

返回结构里有两个分数会影响你怎么用结果。rerank_score 取值 0–3，综合相关性、权威性和时效性，官方称大于等于 1.5 为优质结果；authority 取值 0–4，-1 表示未知，大于等于 3 为极权威。snippet 通常 100–200 字符，summary 通常 600–800 字符，前者适合展示，后者适合直接喂给模型。这两个分数是厂商自定的排序信号，官方没有公布计算方式，不能当作独立的质量评级。

限速在接入前就要算清。Search 与 Fetch 各 5 QPS，按账号计算，与使用哪个 API Key 无关，也与模型并发限制相互独立；打满 5 QPS 一天最多约 43.2 万次请求。超过账号级限制返回 429，Fetch 还额外受目标域名的 QPS 限制，超限同样是 429。一个会并发发起十几次检索的 Agent，很容易在单个账号上撞到这条线。

错误码的语义也影响重试逻辑。Fetch 的 403 表示请求被安全策略拒绝，404 表示没取到可用内容——URL 不可用、被站点策略拦截、目标站点报错、内容类型不支持、页面没有可提取的 Markdown，都归到 404。官方建议只对 408、429 和 5xx 等待后重试，402 先充值，其余 4xx 不改请求就不要重试。

各方说法

The Decoder 10 月 17 日的报道复述了价格与免费截止时间，其请求量数字沿用公司说法；报道本身没有对 Search 与 Fetch 做独立评测。我们查阅的材料里也没有第三方基准能说明这两个接口的检索质量。

Startup Fortune 10 月 18 日的文章补了两个角度。它引用一家未具名媒体的当日快照做价格对照：Brave 约每千次 5 美元、Exa 4–7 美元、Perplexity 1–5 美元、Tavily 8–16 美元；文章自己注明这些服务并不等同，只能当粗略参照，还提醒发布价可能变化——DeepSeek 今年早些时候对另一款产品涨过价。同一篇报道还转述 DeepSeek 隐私政策称个人数据在中华人民共和国境内收集、处理、存储，平台条款受中国法律管辖；隐私政策把用户输入列入改进技术的数据，而 API 条款没有明确说明 API 输入是否用于训练；搜索指南则没有提数据保留期限或存储区域。报道还提到意大利和德国的监管机构已就数据出境对 DeepSeek 采取过行动。

中文侧，量子位 10 月 17 日晚的报道给出同样的 5 元 / 千次和「单次半分钱」，写明失败、无结果、超时不收费，免费期限只写到「11 月 1 日」，没有给出具体时刻；该文也没有提 QPS、索引规模或竞品对比。

Hacker News 上，同一天发布的 V4.1-Flash-1017 讨论帖（2026-10-18 查询时 646 分、548 条回复）里有人贴了试用结果。用户 ytxm 说自己试过搜索，结果好坏参半：搜某款微软产品找不到落地页，搜一个冷门开源包时前几条是 Debian 仓库页面，首页在前十名之内。用户 alex-moon 的回应是自己仍在用 Brave 的搜索 API。这些是个人试用和偏好，不是横向评测，但能说明「便宜」之外还有检索质量问题。

编辑判断

对正在维护代码 Agent 或 RAG 流水线的团队，DeepSeek 的 Search 与 Fetch 最直接的价值是把检索成本写进预算表。按英文价目，100 万次成功检索 750 美元；成功才计费的规则意味着失败重试不额外花钱。真正需要提前设计的是 5 QPS 的账号级上限：它决定了单个账号能支撑多少并发 Agent，价格反而容易算。检索只是 Agent 链路的一段，上下文工程 决定拿到结果之后怎么用，两件事要分开评估。

数据合规是另一半。搜索指南没有写保留期限和存储区域，按 Startup Fortune 转述的隐私政策，数据在中国境内处理。对金融、医疗或面向欧盟客户的团队，这条约束可能比价格更早否决接入，需要法务确认合同条款后再决定。

检索质量目前没有独立证据。我们找到的唯一实测反馈是一条 HN 评论。价格低不等于结果好，先用自己业务里的查询集跑一批对照，再决定是否替换现有的 Brave 或 Tavily 接入，是更稳妥的顺序。

还有两个未知数：发布价会不会像 DeepSeek 今年早些时候那样调整，以及官方是否会补上数据保留和区域的说明。这两点都影响长期成本与合规判断。

怎么试

有 DeepSeek API Key 的话，一条 curl 就能看到 Search 的返回结构：

curl https://api.deepseek.com/v1/tools/search \
  -H "Authorization: Bearer $DEEPSEEK_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"DeepSeek V4 release","count":5,"need_content":true}'

把 query 换成 site:github.com DeepSeek lang:zh after:2025 可以试操作符；再把返回结果里第一条的 url 交给 Fetch：

curl https://api.deepseek.com/v1/tools/fetch \
  -H "Authorization: Bearer $DEEPSEEK_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://example.com/article"}'

测试时记录三件事：返回的 rerank_score 和 authority 分布、空结果的比例、以及 429 出现的频率。前两项决定检索质量，第三项决定你的并发设计。免费只覆盖经这三个客户端的服务端工具调用；指南把按次计费写成默认规则、把这类调用列为暂免，直接调用接口按上表价格计费。