Search 用于搜索网页,Fetch 用于将单个网页提取为 Markdown。按当前规则,两者分别为每千次成功请求 0.75 美元,预算中应与模型 token 费用分别核算。
适合:需要为 Agent 或 RAG 应用接入实时网页信息的开发者调用地址与 API Key
Search 使用 POST /v1/tools/search,Fetch 使用 POST /v1/tools/fetch,以下示例给出完整官方地址。两者接收 JSON,并通过 Authorization Bearer 请求头使用 DeepSeek API Key。
运行示例前,在本地环境或服务端密钥配置中设置 DEEPSEEK_API_KEY。面向公开用户开发应用时,把密钥留在服务端。以下命令采用官方文档的请求结构,需要使用自己的账户权限。
curl --fail-with-body https://api.deepseek.com/v1/tools/search \
-H "Authorization: Bearer $DEEPSEEK_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query":"DeepSeek API documentation","count":5,"need_content":true}'搜索结果与单页抓取
Search 返回 results 数组,包含标题、网址、摘要和可用的来源信息。count 支持 1 到 50 条;需要一并返回可用网页正文时设置 need_content 为 true。没有匹配结果时返回空数组。
Fetch 接收一个网址,并返回标题与 Markdown 正文。应选择与问题相关的结果,阅读原文,并把来源网址与提取内容保存在一起。抓取结果仍受目标网站的可用性和访问规则影响。
curl --fail-with-body https://api.deepseek.com/v1/tools/fetch \
-H "Authorization: Bearer $DEEPSEEK_API_KEY" \
-H "Content-Type: application/json" \
-d '{"url":"https://api-docs.deepseek.com/guides/search/"}'联网搜索与 Fetch 怎么计费?
2026 年 11 月 5 日核查的官方指南中,Search 与 Fetch 分别为每千次成功请求 0.75 美元。Search 需要返回 HTTP 200 且结果非空,Fetch 需要返回 HTTP 200 且取得正文,才符合可计费条件。按这些规则,失败请求、空搜索结果与超时不计费。
count 改变请求返回的搜索结果数量,价格单位仍按请求计算。例如,20,000 次可计费 Search 加 10,000 次可计费 Fetch,按当前标价共 22.50 美元;完整应用预算还应加入模型 token 和其他服务费用。
DeepSeek Harness、Claude Code 和 Codex 服务端工具发起的调用也按成功请求计费。10 月 17 日公告给出的体验期结束时间是 UTC 2026 年 10 月 31 日 16:00,即北京时间 11 月 1 日零点。
QPS 限制与错误处理
指南列出的账户级限制为 Search 100 QPS、Fetch 25 QPS,分别计算。同一账户下不同 API Key 共享对应额度。Fetch 还有目标域名级限制,模型并发则单独管理。
遇到 408、429 或 5xx 时降低请求速度,并采用有次数上限的等待重试。401 应核对鉴权,402 应检查账户余额,其他 4xx 应先修正请求。Fetch 的 403 可能表示安全策略拒绝,404 可能表示无法取得可用网页正文。