
DeepSeek Search API 怎么用:curl 示例与计费
接入 DeepSeek Search API 不需要新申请,用你现有的 DeepSeek API key 就能调。10 月 17 日 DeepSeek 开放 Search 和 Fetch 两个接口,Search 按关键词返回结构化网页结果,Fetch 抓单个网页返回 Markdown 正文,单价都是 5 元/千次成功请求。下面给出端点、curl 和 Python 示例、计费边界,以及 11 月 1 日起的变化。
前置准备:一个 API key 就够
- 到 https://platform.deepseek.com/api_keys 创建 API key,创建后复制保存,之后页面不再展示
- 两个接口共用同一个 key,Bearer 鉴权,无需单独申请权限
- Base URL 是 api.deepseek.com,和现有聊天接口同一个域名

Search 接口:POST /v1/tools/search
Search 按 query 搜索网页,返回结构化结果列表。每个结果带标题、URL、短摘要、面向模型的长摘要、发布日期、rerank_score 相关性评分和 authority 权威度评级。
curl 示例:
curl https://api.deepseek.com/v1/tools/search \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $DEEPSEEK_API_KEY" \
-d '{"query": "DeepSeek V4.1-Flash-1017 发布", "max_results": 5}'
请求参数:
- query:搜索词,上限 128 个字符
- max_results:返回结果条数,1 到 50 之间,不传默认 10
query 支持官方查询操作符:site: 和 -site: 限定或排除站点,lang: 限定语言(如 zh、en),after: 和 before: 限定发布日期,双引号做精确短语匹配。
Fetch 接口:POST /v1/tools/fetch
Fetch 抓取单个网页,返回页面标题和 Markdown 格式正文,只需要传一个 url 参数,适合把搜索结果里的链接抓成全文喂给模型。
curl 示例:
curl https://api.deepseek.com/v1/tools/fetch \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $DEEPSEEK_API_KEY" \
-d '{"url": "https://api-docs.deepseek.com/zh-cn/guides/search_fetch"}'
Fetch 受目标站点可用性和访问策略限制,能不能抓到取决于对方网站是否允许抓取。官方文档见 Search & Fetch 指南。
Python 示例:两个函数搞定搜索加抓取
import os
import requests
API_KEY = os.environ["DEEPSEEK_API_KEY"]
BASE_URL = "https://api.deepseek.com"
HEADERS = {"Authorization": f"Bearer {API_KEY}"}
def search(query: str, max_results: int = 10) -> dict:
resp = requests.post(
f"{BASE_URL}/v1/tools/search",
headers=HEADERS,
json={"query": query, "max_results": max_results},
)
resp.raise_for_status()
return resp.json()
def fetch(url: str) -> dict:
resp = requests.post(
f"{BASE_URL}/v1/tools/fetch",
headers=HEADERS,
json={"url": url},
)
resp.raise_for_status()
return resp.json()
# 先搜再抓
results = search("DeepSeek Search API", max_results=3)
print(results)
请求体字段名以官方文档最新版为准,接入前先过一眼 DeepSeek API Docs 的 Search & Fetch 章节。传参不对通常返回 4xx,按报错信息调整即可。

计费规则:5 元/千次,什么时候才扣钱
两个接口都按成功请求次数计费,不看 token 用量,也不看结果条数。单价每 1000 次成功请求 5 元,约 0.75 美元/千次。
什么时候才算一次成功请求:
| 条件 | Search | Fetch |
|---|---|---|
| 计费 | 返回非空结果列表 | 返回页面正文且 HTTP 200 |
| 不计费 | 空结果、失败、超时 | 抓取失败、空内容、超时 |
失败请求、空结果、超时都不产生费用。速率限制是每个账号下 Search 和 Fetch 各自每秒 5 次(5 QPS),两者独立计数,Fetch 还有按域名的额外限制,超限返回 HTTP 429。

11 月 1 日前后:收费边界变了
10 月 18 日 DeepSeek 公告确认:当前在 DeepSeek Harness、Claude Code、Codex 里使用 DeepSeek API 时,已经会通过 Server 端工具调用访问 Search/Fetch 接口,这部分调用现在不计费,2026 年 11 月 1 日 00:00 起按次计费。
| 调用场景 | 现在 | 2026年11月1日 00:00 起 |
|---|---|---|
| 直接调 /v1/tools/search 或 /v1/tools/fetch | 5 元/千次成功请求 | 5 元/千次成功请求 |
| Harness / Claude Code / Codex 里服务端工具调用 | 免费 | 按次计费 |
| Claude Code 的 Web Search 工具、Codex 的 web_search 触发 | 免费(11 月 1 日前) | 按次计费 |
对想省钱的开发者,10 月底是测试窗口:在 Claude Code 或 Codex 里配 DeepSeek 模型实测联网搜索暂时不花钱,11 月 1 日后再跑就要算账了。

常见报错速查
| 报错 | 原因 | 处理 |
|---|---|---|
| HTTP 402 | 余额不足 | 充值后重试 |
| HTTP 429 | 超过 5 QPS 或 Fetch 域名限制 | 降速等待后重试 |
| HTTP 408 / 5xx | 服务端繁忙或超时 | 等待后重试 |
| 其他 4xx | 请求参数或鉴权问题 | 检查参数,不要不改请求就反复重试 |
错误格式兼容 OpenAI 标准,解析 error 字段即可。
常见问题
DeepSeek Search API 多少钱?
每 1000 次成功请求 5 元,约 0.75 美元/千次。空结果、失败、超时不收费,结果条数不影响价格。
Search 和 Fetch 有什么区别?
Search 按 query 返回结构化结果列表,适合先搜;Fetch 按 url 抓单个网页返回 Markdown 正文,适合把结果抓成全文。
现在调用要花钱吗?
直接调接口按 5 元/千次计费。在 Harness、Claude Code、Codex 里通过服务端工具调用目前免费,11 月 1 日 00:00 起按次计费。
限速是多少?
每个账号 Search 和 Fetch 各 5 QPS,独立计数;Fetch 还有单域名额外限制,超限返回 HTTP 429。
怎么判断结果质量?
结果带 rerank_score 相关性评分和 authority 权威度评级,评分 1.5 以上视为高质量结果,权威等级 3 以上为高度权威来源。
需要单独申请权限吗?
不需要,用现有 DeepSeek API key 即可,Bearer 鉴权,Base URL 是 api.deepseek.com。

京ICP备2024094994号-29