DeepSeek 搜索 API 正式开放：每千次请求 $0.75，开发者如何接入？

发布日期：2026-10-19 | 话题：DeepSeek 搜索 API / AI 搜索工具 / RAG 开发

DeepSeek 于 2026 年 10 月正式开放独立搜索与抓取 API，通过 /v1/tools/search 和 /v1/tools/fetch 两个端点向开发者提供实时联网检索能力，定价为每千次成功请求 $0.75，底层由 DeepSeek 自研搜索引擎驱动。文章详解了两个端点的参数结构、查询语法操作符（site/lang/after/before 等）、返回字段含义（rerank_score 相关性评分、authority 权威度分级），以及完整的 Python 和 cURL 接入示例；横向对比了 Serper API 和 Bing Search API 在定价、数据来源和功能覆盖上的差异，DeepSeek 搜索 API 约为同类 Google 数据服务的四分之一；并归纳了 RAG 管道、Agent 工具调用、内容监控三类核心场景的选型建议，以及生产环境的错误处理和 QPS 节流最佳实践。计费从 2026 年 11 月 1 日北京时间零点正式启动，此前通过 Harness 框架的服务端工具调用暂时免费。

DeepSeek 搜索 API 是什么

DeepSeek 搜索 API 是 DeepSeek 推出的实时网页搜索与内容抓取服务，底层由 DeepSeek 自研搜索引擎驱动，分为两个独立端点：

Search（POST /v1/tools/search）：根据查询词检索网页，返回结构化结果列表，每条结果含标题、摘要、相关性评分和来源权威度
Fetch（POST /v1/tools/fetch）：抓取指定 URL 的页面内容，返回 Markdown 格式全文

两个端点统一使用 https://api.deepseek.com 作为 Base URL，以 Bearer Token 方式鉴权，与 DeepSeek 现有的 Chat Completions API 共用同一套账号和 API Key 体系。

核心数据点：

定价：Search 和 Fetch 均为 $0.75 / 千次成功请求（来源：DeepSeek 官方定价文档，2026 年 10 月）
速率限制：每个端点独立计算，均为 5 QPS（账号级别）
计费口径：仅 HTTP 200 且有结果的请求计费，空结果和错误不计费
收费启动时间：2026 年 11 月 1 日 00:00（北京时间），此前通过 Harness 调用暂免费

核心参数与返回结构

Search 端点

请求时必填的只有 query 字段（1-128 个 Unicode 字符），其余为可选：

参数	类型	默认值	说明
`query`	string	—	搜索词，支持语法操作符
`count`	integer	10	返回结果数，最多 50
`ori_question`	string	—	用户原始问题，辅助理解搜索意图
`localization`	string	`""`	IP 地址，用于本地化结果
`need_content`	boolean	false	是否在结果中附带页面全文

返回的每条结果包含 rerank_score（0-3 分的相关性评分，1.5 分以上视为高质量）、authority（0-4 的权威度分级）和 date（RFC 3339 格式的发布时间）。

查询语法操作符

Search 端点原生支持以下语法，可在 query 字段中直接使用：

site:example.com          # 限定来源域名
-site:example.com         # 排除特定域名
"exact phrase"            # 精确短语匹配
-word                     # 排除包含某词的结果
lang:zh,en                # 限定语言（逗号分隔）
after:2026-01-01          # 限定发布时间区间
before:2026-06-01

Fetch 端点

请求只需提供目标 URL（HTTP/HTTPS，最长 8192 字符），返回 title 和 content（Markdown 格式页面全文）。每个域名有独立的 QPS 限制，频繁抓取同一域名会触发 429。

接入示例

以下是两个端点的最小可运行示例（Python）：

import requests

BASE = "https://api.deepseek.com"
HEADERS = {
    "Authorization": "Bearer <YOUR_DEEPSEEK_API_KEY>",
    "Content-Type": "application/json",
}

# 搜索
resp = requests.post(
    f"{BASE}/v1/tools/search",
    headers=HEADERS,
    json={
        "query": "DeepSeek V4 release after:2026-09-01",
        "count": 5,
        "need_content": False,
    },
)
for r in resp.json()["results"]:
    print(r["rerank_score"], r["title"], r["url"])

# 抓取单页
resp = requests.post(
    f"{BASE}/v1/tools/fetch",
    headers=HEADERS,
    json={"url": "https://example.com/article"},
)
print(resp.json()["content"][:500])

cURL 版本：

# 搜索
curl https://api.deepseek.com/v1/tools/search \
  -H "Authorization: Bearer <YOUR_DEEPSEEK_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{"query": "AI search API 2026", "count": 5}'

# 抓取
curl https://api.deepseek.com/v1/tools/fetch \
  -H "Authorization: Bearer <YOUR_DEEPSEEK_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com/article"}'

适用场景与选型建议

DeepSeek 搜索 API 定位于为 AI 应用提供实时信息补充，最典型的三类使用场景是：

RAG（检索增强生成）管道：将 Search 端点作为知识检索层，替代或补充本地向量数据库，适合需要实时数据但不想维护爬取基础设施的团队。

Agent 工具调用：搜索和抓取作为 Agent 的原生工具，配合 DeepSeek Harness 或兼容 OpenAI function calling 的框架，无需额外封装即可让模型主动发起搜索。

内容监控与竞品追踪：利用 after: 时间语法和 site: 域名限定，定期抓取特定来源的最新发布，适合需要新闻监控或技术动态追踪的场景。

与主流搜索 API 的关键差异

维度	DeepSeek Search API	Serper API（Google 数据）	Bing Search API
定价	$0.75/千次请求	$3/千次（基础套餐）	$3-7/千次
数据来源	DeepSeek 自研引擎	Google 搜索结果	Bing 搜索结果
Fetch 端点	内置，同价格	需单独调用	不含
结构化评分	rerank_score + authority	无原生相关性分	无
查询语法	原生支持	部分支持	部分支持
QPS 上限	5（免费额度内）	视套餐而定	视套餐而定

单从定价看，DeepSeek 搜索 API 约为同类 Google 数据服务的 1/4，对调用量较大的 AI 应用有明显成本优势。代价是数据来源为自研引擎而非 Google，在中文内容覆盖上表现较好，英文长尾查询的结果质量有待验证。

开发者可以通过标准 OpenAI 兼容接口接入多款推理服务来组合调用，例如七牛云的 AI 推理平台支持 OpenAI SDK 格式，可与 DeepSeek 搜索 API 在同一个工作流中混用，无需修改接口调用代码。

DeepSeek 当前模型与 API 生态

DeepSeek 搜索 API 与其推理 API 共享账号体系，目前推理端主要提供两个模型：

deepseek-flash（由 DeepSeek-V4.1-Flash-1017 提供服务）：低成本快速推理，缓存命中时输入仅需 $0.003/百万 token（峰时 $0.006），输出 $0.60/百万 token（非峰时）
deepseek-v4-pro：更强推理能力，输入缓存命中 $0.022/百万 token（峰时 $0.044），输出 $1.98/百万 token（非峰时）

峰时定义为周一至周五 UTC 01:00-04:00 和 06:00-10:00，中国法定节假日全天按非峰时计费。

搜索 API 的加入让 DeepSeek 平台从"纯推理"扩展为"推理 + 实时数据"的闭环，这与 OpenAI 将 Web Search 整合进 ChatGPT 和 Responses API 的方向一致，是主流 AI 平台向工具化演进的标志性节点。

错误处理与生产注意事项

HTTP 状态码	含义	处理建议
200	成功，计费	—
400	请求格式错误	检查字段类型和必填项，不要重试
401	API Key 无效	检查 Authorization header
402	余额不足	充值后重试
403	Fetch 被安全策略拒绝	换 URL，不要重试该请求
404	Fetch 无法获取有效内容	页面可能需要登录或已下线
429	超出 QPS 限制	等待后重试，实现指数退避
5xx	服务或下游超时	等待后重试

生产环境建议的最佳实践：

只对 429 和 5xx 实现自动重试，其他 4xx 不重试，修正请求后再发
Fetch 加域名节流：同一域名控制在 1 QPS 以内，避免触发域名级限制
用 rerank_score 过滤低质结果：建议设阈值 1.5，低于此分的结果在 RAG 场景中通常带来噪声
need_content 按需开启：大多数场景只需摘要（summary 字段），开启全文会显著增加响应体积

常见问题

Q：DeepSeek 搜索 API 的 $0.75 是每次调用还是每千次？

每千次成功请求（HTTP 200 且有结果）计费 $0.75，折合单次约 $0.00075。空结果返回和失败请求不计费。计费从 2026 年 11 月 1 日北京时间零点起正式启动，在此之前通过支持的 Agent 框架调用的服务端工具调用暂时免费。

Q：Search 和 Fetch 的 QPS 限制是共用还是独立的？

两个端点独立计算 QPS，各自 5 次/秒。Search 的 QPS 消耗不影响 Fetch 的配额，反之亦然。两者都在账号级别计算，同一账号下多个 API Key 共用同一配额池。

Q：如何在 Agent 框架中使用这两个工具？

DeepSeek Harness 原生内置了对这两个工具的调用支持。如果使用 OpenAI function calling 兼容的其他框架，可以将搜索和抓取手动封装成 tool definition，以标准 function calling 格式注册后让模型主动调用。搜索结果中的 summary 字段（约 600-800 字）专为输入给模型设计，信息密度比 snippet 更高。

Q：rerank_score 和 authority 字段如何在 RAG 中使用？

rerank_score 是 0-3 的浮点数，反映结果与查询的相关性，1.5 以上为高质量。authority 是 0-4 的整数，反映来源的权威程度（-1 表示未知），3 以上为高权威来源。在 RAG 场景中，通常先用 rerank_score ≥ 1.5 过滤，再结合 authority ≥ 2 筛选可信度更高的内容送入上下文。

Q：Fetch 返回的 Markdown 内容有什么局限？

Fetch 会过滤明显的广告和导航类 HTML，将主体内容转为 Markdown 返回，但对重度 JavaScript 渲染的单页应用效果有限。被安全策略拦截的 URL 返回 403，需要登录才能访问的页面通常返回空内容（404）而非登录表单。对于这类场景需要本地浏览器自动化方案作为补充。

结语

DeepSeek 搜索 API 的正式开放填补了其 API 生态中实时数据这块拼图。$0.75/千次的定价在同类服务中具有竞争力，内置的相关性评分和权威度字段对 RAG 应用来说减少了额外的后处理工作。主要约束是 5 QPS 的速率上限和 11 月 1 日起的正式计费节点，高频调用场景的团队需要在此之前评估成本并做好配额规划。

根据 DeepSeek 官方文档（api-docs.deepseek.com，2026 年 10 月），以上定价和参数规格适用于当前版本，具体 SLA 和速率提升计划以官方公告为准。