DeepSeek Search API 怎么用:curl 示例与计费封面图
AI 编程约 8 分钟

DeepSeek Search API 怎么用:curl 示例与计费

AI 指南··◉ 0 浏览

接入 DeepSeek Search API 不需要新申请,用你现有的 DeepSeek API key 就能调。10 月 17 日 DeepSeek 开放 Search 和 Fetch 两个接口,Search 按关键词返回结构化网页结果,Fetch 抓单个网页返回 Markdown 正文,单价都是 5 元/千次成功请求。下面给出端点、curl 和 Python 示例、计费边界,以及 11 月 1 日起的变化。

前置准备:一个 API key 就够

DeepSeek 开放平台官方文档:创建 API key 步骤入口

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,按报错信息调整即可。

DeepSeek 官方 Search 与 Fetch 接口文档页

计费规则:5 元/千次,什么时候才扣钱

两个接口都按成功请求次数计费,不看 token 用量,也不看结果条数。单价每 1000 次成功请求 5 元,约 0.75 美元/千次。

什么时候才算一次成功请求:

条件 Search Fetch
计费 返回非空结果列表 返回页面正文且 HTTP 200
不计费 空结果、失败、超时 抓取失败、空内容、超时

失败请求、空结果、超时都不产生费用。速率限制是每个账号下 Search 和 Fetch 各自每秒 5 次(5 QPS),两者独立计数,Fetch 还有按域名的额外限制,超限返回 HTTP 429。

DeepSeek Search/Fetch API 计费条件与限速规则示意

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 日后再跑就要算账了。

DeepSeek 10月18日网页搜索与抓取计费官方公告

常见报错速查

报错 原因 处理
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。

评论 (0)

?
0/1

还没有评论,来发第一条吧

网站上的服务均为第三方提供,
请用户注意自行甄别。

北京酷讯互动科技有限公司

备案京ICP备2024094994号-29

© 2026 AI345 · All Rights Reserved

用户服务协议·隐私政策