☰
DeepSeek 开放搜索 API:Search、Fetch 怎么用,11 月 1 日计费影响谁?
2026/10/29 2:12:04 网站建设 项目流程

DeepSeek 在 10 月 17 日开放了自研搜索 API。对开发者更直接的变化是:Agent 和 RAG 应用可以分别调用搜索、网页正文提取接口,不必把“联网”全部塞进一次聊天请求里。

还有一个临近的时间点:官方指南写明,经 DeepSeek API 在 DeepSeek Harness、Claude Code 或 Codex 中产生的服务端 Search、Fetch 工具调用,目前免费,将从北京时间 2026 年 11 月 1 日 00:00开始按请求计费。这个说明有适用范围,不能理解为所有模型调用都免费到月底。

Search 找页面,Fetch 取正文

两个接口解决的是不同任务。Search 接收问题,找相关网页;Fetch 接收一个网页地址,把能提取的正文返回为 Markdown。

接口请求路径主要输入返回什么
SearchPOST /v1/tools/searchqueryresults 数组,包含标题、地址、摘要等
FetchPOST /v1/tools/fetchurltitle 与 Markdown 格式的 content

例如,要回答“某个开源库最近改了什么”,先用 Search 找官方更新日志,再选中需要的页面调用 Fetch,最后把正文交给模型归纳。仅在提示词里写“请联网搜索”,不会让普通聊天请求自动具备这条调用链。应用或支持该能力的 Agent 仍要负责执行工具。

Search 也有need_content参数。设为true时,可以尝试在搜索结果中带回正文;正文不可用时,content仍可能为空。已经拿到所需正文,就不必再对同一页重复 Fetch。

一个请求例子,看懂该取哪些字段

下面是 Search 的请求体示例,表示搜索近期官方材料,最多取三个候选,并尝试取得正文:

{ "query": "DeepSeek site:github.com after:2026-10-01", "count": 3, "need_content": true }

收到结果后,先看title、url是否对应需要的资料,再看summary和content。摘要适合筛选,正文适合进一步引用和分析;不要把搜索排序分数当成事实正确率。

如果需要单独提取某页,把选中结果的url原样放进 Fetch 请求。它能否成功,仍取决于目标网站的可访问性、内容类型和访问政策。搜到了标题,不代表一定能取得全文。

按成功请求收费,结果条数不直接决定单价

官方指南列出的 Search、Fetch 价格相同,均为每 1,000 次成功请求 0.75 美元。Search 必须返回非空结果,Fetch 必须取得正文,且 HTTP 状态为 200,才满足该文档的计费条件;失败、空搜索结果和超时不计费。

合成调用量计算工具请求费用
1,000 次成功 Search1,000 ÷ 1,000 × 0.750.75 美元
再加 2,000 次成功 Fetch2,000 ÷ 1,000 × 0.751.50 美元
两项合计0.75 + 1.502.25 美元

这是按文档单价计算的工具费用示例,不包含模型读取正文、生成答案的 token 费用。count控制一次搜索返回多少条结果,不直接改变这次 Search 的单价;但把更多正文送给模型,仍可能增加后续输入费用。

已经接入 Agent,优先检查两个地方

第一,记录一次任务实际执行了多少次 Search、Fetch。模型回答一次,背后可能多轮搜索;重复提取同一页也会累积请求。把问题、候选地址和已取正文对应起来,才能发现重复调用。

第二,分别限制搜索和抓取的请求速率。官方当前列出账号级 Search 100 QPS、Fetch 25 QPS,Fetch 还受目标域名的速率限制。它们与模型并发额度分开计算,同账号换一把 Key 不会变成新的请求池。

对准备接入的人,先跑通“一个问题→少量候选→必要正文→带出处的回答”即可;已经在用上述服务端工具的人,11 月 1 日前应把工具调用次数纳入成本统计。

来源:DeepSeek《Change Log》《Search & Fetch》官方指南。

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询