DeepSeek Search API 免费窗口：价格、Fetch 和 10 月 31 日截止

简短结论： DeepSeek Search API 只在三个编码工具里免费，而且只到 2026 年 10 月 31 日 16:00 UTC。在此之前，Claude Code、Codex 或 DeepSeek Harness 在服务端发起的 Search 和 Fetch 调用不收费。之后，以及所有直接打到端点的调用，每个端点按 每 1,000 次成功请求 0.75 美元 计费。失败调用、空结果和超时从不收费。

DeepSeek 在 2026 年 10 月 17 日向所有人开放了 Search 和 Fetch API，与 DeepSeek-V4.1-Flash-1017 发布同期。它们给智能体返回查询的最新网页结果，以及任意页面的干净 Markdown。本指南说明什么免费、窗口结束后多少钱、速率限制，以及第一次请求怎么发。

下面每条事实都来自 DeepSeek 的 Search 与 Fetch 指南 和价格页，阅读日期是 2026 年 10 月 28 日。

AI Coding 交流群

如果你也在用 AI 写代码，或者正在研究 Cursor、Claude Code 这些工具，欢迎加入以下交流群。群里平时会聊一些 AI 编程的实际用法、开发工作流，还有各种新工具和新玩法。

DeepSeek Search API 免费吗？

免费，但有两道限制：从哪里调用，以及何时。DeepSeek 文档说，通过 DeepSeek Harness、Claude Code 或 Codex 在服务端发起的 Search 和 Fetch 调用「目前免费」。这些调用的按次计费从 2026 年 11 月 1 日 UTC+8 的 00:00 开始，也就是 2026 年 10 月 31 日 16:00 UTC。

有两个限制让它算不上真正的零美元路径：

1. 你仍然需要有余额的 DeepSeek API 密钥。 免费窗口覆盖的是搜索调用，不是模型。DeepSeek 的 Claude Code 集成页 说，总结搜索结果会额外使用 LLM 请求，这些 token 按正常模型价格计费。
2. 窗口只覆盖服务端工具调用。 文档把它限定在上述三个工具。如果你自己的代码调用端点，从第一次成功请求起就付费。

如果要找的是免费的 DeepSeek 模型，而不是免费搜索，可以看「DeepSeek 是否免费」列出的各条路径，「免费获取 DeepSeek API 密钥」则说明密钥本身。

DeepSeek Search 和 Fetch API 做什么

DeepSeek Search API 接收查询，返回结构化网页结果：标题、URL、摘要片段、面向模型的更长总结、可选的整页内容、相关性分数和权威性分数。DeepSeek Fetch API 接收一个 URL，返回该页标题，以及 Markdown 形式的内容。两者合起来，让智能体用两次调用完成搜索和阅读。

研究型智能体通常搜索一次，再抓取两三页，窗口结束后每一次都是单独计费的调用。Search 支持运算符：site:、-site:、"phrase"、-term、lang:en,ja、after: 和 before:。

可以对照「免费网页搜索 API」、「Claude 网页搜索 API」和「Perplexity Search API」来看其他选择。

免费窗口结束后的 DeepSeek Search API 价格

窗口关闭后，两个端点计费方式相同：

费用从 DeepSeek 余额扣除。价格页说，同时有赠送余额和充值余额时，先用赠送余额。

一个研究智能体每天跑 200 个任务，每个任务一次搜索、三次抓取，粗算如下：

• 200 次搜索 × 0.00075 美元 = 0.15 美元
• 600 次抓取 × 0.00075 美元 = 0.45 美元
• 合计：每天 0.60 美元，大约每月 18 美元，不含模型 token

既然 count 不改变价格，就在一次调用里要最多 50 条结果，而不是翻页。模型一侧，deepseek-flash 在非高峰、缓存未命中时，输入每百万 token 0.15 美元，输出每百万 token 0.60 美元，高峰时段翻倍。详见「DeepSeek V4.1 Flash 价格」。

DeepSeek Search API 速率限制

有些第三方文章写成 5 QPS。DeepSeek 自己的指南给了不同数字，做计划应以这些为准：

• Search： 每秒 100 次查询
• Fetch： 每秒 25 次查询，另有一个未公布数值的按域名限制

限制按账户计算，覆盖你的全部 API 密钥，并且与模型并发分开。Search 和 Fetch 独立计量，所以一波抓取不会吃掉搜索配额。超出后返回 HTTP 429。

注意按域名的 Fetch 限制：智能体从同一个文档站抓 20 页，可能远低于 25 QPS 就撞上它。同一域名的抓取要拉开间隔，并对 429 做退避重试。

端点，以及第一次 DeepSeek Search API 调用

两个端点都是 POST，使用 bearer token，请求体为 JSON：

• Search：https://api.deepseek.com/v1/tools/search
• Fetch：https://api.deepseek.com/v1/tools/fetch

Search 请求字段

下面的搜索请求取自文档：

curl https://api.deepseek.com/v1/tools/search \
  -H "Authorization: Bearer $DEEPSEEK_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query": "DeepSeek V4 release", "count": 5, "need_content": true}'

results 数组的每一项包含 title、url、snippet、summary、content、site_name、site_icon、date（UTC RFC 3339 或 null）、rerank_score 和 authority。抓取之前先用其中两个过滤：

• rerank_score 从 0 到 3。DeepSeek 把 1.5 及以上视为高质量。
• authority 从 0 到 4，未知为 -1。3 及以上表示高度权威的来源。

抓取请求只有一个字段 url（HTTP 或 HTTPS，最长 8,192 个字符，不能内嵌用户名或密码）：

curl https://api.deepseek.com/v1/tools/fetch \
  -H "Authorization: Bearer $DEEPSEEK_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com/article"}'

它返回 title（可能为空）和 Markdown 形式的 content。

你会看到的错误

错误体沿用 OpenAI 形状：message、type、param（始终为 null）和 code。

从 Claude Code 或 Codex 使用 Search，与直接调用

免费窗口只在编码工具替你发起调用时适用，所以配置决定账单。

Claude Code。 把 Claude Code 指向 DeepSeek 兼容 Anthropic 的端点，DeepSeek API 会在服务端运行 Web Search 工具。下面是 DeepSeek 页面上的核心变量：

export ANTHROPIC_BASE_URL=https://api.deepseek.com/anthropic
export ANTHROPIC_AUTH_TOKEN=<your DeepSeek API key>
export ANTHROPIC_MODEL=deepseek-flash[1m]

完整代码块还会设置另外几个模型变量，从 DeepSeek 页面复制。

Codex。 按 DeepSeek 的 Codex 集成页，Codex 内置网页搜索只对 deepseek-v4-pro 生效。安装脚本默认关闭网页搜索，所以在 ~/.codex/config.toml 里写下面两行并重启：

model = "deepseek-v4-pro"
web_search = "live"

代价是：deepseek-v4-pro 每个 token 比 deepseek-flash 更贵。

直接调用。 当你在做自己的智能体，或想自己控制 count、need_content 和运算符时，直接调用端点。从第一次成功调用起付费。如果只想要一个编码时顺便查资料的智能体，就在窗口期内使用 Claude Code 或 Codex。

把 Search 和 Fetch 接进产品之前

先证明鉴权、响应形状和错误与文档一致，再接到产品里。编码智能体可以编写并运行这些检查，让测试留在团队能在 CI 里重跑的项目中。

值得覆盖的断言：搜索返回 200，results 数组里的 rerank_score 在 0 到 3 之间；对 https://example.com 的抓取返回 200 且内容非空；错误密钥返回 401。窗口结束后，一次完整运行会有两次计费调用（一次搜索、一次抓取），费用 0.0015 美元。401 检查不计费，因为失败请求不收费。

原文给出了来源产品 CLI 的安装、建端点和运行测试的命令，并提到其免费方案最多 4 名用户。Apifox 是否提供同名 CLI，待核实，因此不照搬。

常见问题

10 月 31 日之后 DeepSeek Search API 还免费吗？ 不免费。从 2026 年 10 月 31 日 16:00 UTC 起，经 Claude Code、Codex 和 DeepSeek Harness 的 Search 与 Fetch 调用，按每 1,000 次成功请求 0.75 美元计费，与直接调用相同。

DeepSeek Fetch API 免费吗？ 条件与 Search 相同：在截止前由 Claude Code、Codex 或 DeepSeek Harness 在服务端调用时免费，之后每 1,000 次成功请求 0.75 美元。

在 Claude Code 里使用免费搜索需要 DeepSeek API 密钥吗？ 需要。Claude Code 必须通过 https://api.deepseek.com/anthropic 使用 DeepSeek API 密钥，它用来总结结果的模型 token 按正常价格计费。

DeepSeek Search API 的速率限制是多少？ DeepSeek 指南列出每账户 Search 100 QPS、Fetch 25 QPS，Fetch 另有未公布的按域名限制。超出后返回 HTTP 429。

搜索没有结果时会计费吗？ 不会。空结果、失败请求和超时不计费。Search 只在 HTTP 200 且 results 数组非空时计费。

要更多结果会更贵吗？ 不会。count（1 到 50）不改变价格，所以一次 50 条结果的搜索和一次 5 条结果的搜索费用相同。

开发必备：API 全流程管理神器 Apifox

介绍完上文的内容，我想额外介绍一个对开发者同样重要的效率工具 —— Apifox。作为一个集 API 文档、调试、设计、测试、Mock、自动化测试于一体的工具，Apifox 是目前提升研发效率的首选。

如果你正在开发项目，不妨试试其极其友好的界面设计，它完全兼容 Postman 和 Swagger 数据格式，导入数据非常方便，，即使是新手也能很快上手，点击这里即可注册使用。

值得一提的是，除了个人和常规团队使用，针对有高安全合规要求、或需要在内网环境协作的企业，Apifox 还提供了深度定制的私有化部署方案。

获取专属报价与部署方案

详细的私有化部署系统架构与安全白皮书

针对您公司规模的专属报价单

免费的 1v1 专属产品演示 (Demo) 机会

获取部署方案

* 提交后，我们的客户经理将在 1 个工作日内与您联系

林俊锋 企业微信

@Apifox 专属顾问

扫码备注: 私有化 + 公司名