DeepSeek Search API 开放搜索与抓取：每 1000 次成功请求收费 0.75 美元
DeepSeek Search API 是面向智能体和 RAG（检索增强生成）应用的实时网页搜索接口；配套的 Fetch API 则负责抓取指定网页，并以 Markdown 返回内容。两者都是原始 JSON API，使用 DeepSeek API 相同的 Bearer 密钥认证。此次定价的重点是：搜索与抓取按“成功请求”计费，每 1000 次收费 0.75 美元，而不是按 token 或返回结果数量收费。
搜索与抓取分别做什么
Search API 接收查询词，返回结构化结果，通常包括标题、URL、摘要、内容、日期和站点信息等；一次搜索没有匹配结果时，会返回空的 results 数组。Fetch API 只处理一个 URL，返回网页标题和 Markdown 内容。也就是说，搜索用于发现候选页面，抓取用于读取指定页面，不能把两者视为同一个接口。
价格与“成功请求”的定义
只有 HTTP 200 且实际产生结果的请求才计费：Search 必须返回非空结果数组，Fetch 必须返回网页内容。失败请求、空搜索结果和超时不收费；Search 的 count 只控制返回结果数量，不会改变单次请求价格。
通过 DeepSeek Harness、Claude Code 或 Codex 使用时，服务端发起的工具调用目前免费；按请求计费将于北京时间 2026 年 11 月 1 日 00:00 起开始。文档同时说明，Search 与 Fetch 的 QPS（每秒请求数）分别限制，并按账号计算，与使用哪一个 API 密钥无关；Fetch 还受目标域名的独立 QPS 限制。
最小调用方式
调用前需要准备 DeepSeek API Key，并在请求头中加入 Bearer 认证和 Content-Type: application/json。搜索接口地址为 https://api.deepseek.com/v1/tools/search，请求体至少可包含 query；还可设置 count 和 need_content。抓取接口地址为 https://api.deepseek.com/v1/tools/fetch，请求体使用 url 字段。
如何计算实际成本
按每次成功请求0.00075美元计算，月度成本可用“成功的搜索次数＋成功的抓取次数”乘以0.00075估算。例如，1万次成功请求对应7.5美元；搜索一次返回多个结果，仍只按一次请求计费，count 不会改变价格。需要注意，只有产生实际结果的请求才进入计费统计：空搜索结果、超时、失败请求以及未返回网页内容的抓取请求均不收费。
接入时的参数与返回结果
Search 的请求体可使用 query、count 和 need_content。count 用于控制返回数量，取值应在1至50之间；查询语法会原样传递，因此可以组合 site:、OR、lang: 和 after: 等条件。成功响应为HTTP 200，并在 results 中返回标题、URL、摘要、内容、站点信息、日期及相关评分等字段。
Fetch 每次只接收一个 url，成功后返回 title 和 Markdown 格式的 content。它不是对任意网页的无条件下载：目标站点的可用性和访问策略会影响结果。因此，更稳妥的流程是先用 Search 筛选候选页面，再将需要深入阅读的具体 URL 交给 Fetch。
错误处理与并发限制
接口错误采用兼容 OpenAI API 的格式，错误对象包含 message、type、param 和 code。遇到408、429或5xx，可等待后重试；402表示账户需要充值。其他4xx通常意味着请求参数或权限存在问题，应修改请求后再发起，而不是盲目重试。
Search 和 Fetch 的QPS分别计算，互不消耗额度；限制按账号生效，与使用的API Key无关，也独立于模型并发限制。Fetch 还额外受单个目标域名的QPS限制，超过任一限制都会收到429。对智能体和RAG应用而言，这意味着应设置退避重试、控制并发，并避免对同一域名集中抓取。
