核心功能：实时网络访问能力

DeepSeek 正式推出搜索 API 与获取 API，旨在为智能体及 RAG（检索增强生成）应用提供实时网络内容访问权限。

  • 搜索 API：基于 DeepSeek 自研搜索引擎，根据查询返回结构化网页结果。
  • 获取 API：检索指定单个网页，并以 Markdown 格式返回其内容。

两者均采用原始 JSON API 形式，共用 DeepSeek API 的 Bearer 认证机制，基础 URL 为 https://api.deepseek.com。

技术细节与参数规范

认证方式
请求头需包含 Authorization: Bearer <DeepSeek API Key> 及 Content-Type: application/json。

搜索 API 特性
搜索端点为 POST /v1/tools/search。支持丰富的查询操作符，包括：

  • site: / -site:：限定或排除特定站点。
  • lang:：限定语言代码（如 zh,en）。
  • after: / before:：限定发布日期。
  • "..."：精确匹配短语。

响应结果包含 rerank_score（相关性评分）、title、url、snippet（短摘要）、summary（长摘要）及 authority（权威等级）等字段。评分 1.5 以上视为高质量结果，权威等级 3 以上表示高度权威来源。

获取 API 特性
获取端点为 POST /v1/tools/fetch。仅需传入 url 参数，返回页面标题及 Markdown 格式内容。该操作受目标站点可用性及访问策略限制。

计费策略与速率限制

按成功请求计费
搜索与获取 API 均按成功请求次数计费，而非 Token 用量或结果数量。价格为每 1,000 次成功请求 0.75 美元。

  • 计费条件：仅当请求返回 HTTP 200 且产生有效结果（搜索返回非空数组，获取返回页面内容）时计费。
  • 免费窗口期：通过 DeepSeek Harness、Claude Code 或 Codex 调用的服务端工具目前免费。按次计费将于北京时间 2026 年 11 月 1 日 00:00 正式生效。

速率限制（QPS）
每个账户对搜索和获取 API 分别拥有独立的 5 QPS（每秒请求数）限制。超出限制将返回 HTTP 429 错误。此外，获取 API 还设有单域名 QPS 限制。

错误处理
错误格式兼容 OpenAI 标准。对于 HTTP 408、429 或 5xx 错误，建议等待后重试；HTTP 402 需充值后重试；其他 4xx 错误不应在不修改请求的情况下重试。