跳到主要内容
开发

DeepSeek Search/Fetch API 收费指南:Claude Code、Codex 接入与成本测算

DeepSeek Search/Fetch API 将于 2026 年 11 月 1 日对符合条件的编程工具服务端调用收取请求费。本文核对成功请求单价、中英页面币种、模型 Token 分账,教你识别 Claude Code/Codex 的真实后端,并用最小示例和错误表估算成本。

本文目录 正在整理章节

如果你把 Claude Code、Codex 或自己的 Agent 接到了 DeepSeek API,11 月起“联网搜索要收费”这句话只说对了一半。DeepSeek 10 月 17 日更新日志开放了 Search 与 Fetch API;官方中文指南说明,使用 DeepSeek API 的 DeepSeek Harness、Claude Code、Codex 中,服务端已会调用这两个接口,这部分请求当前免收请求费,将从北京时间2026 年 11 月 1 日 00:00起按次计费。它没有说所有 Claude Code 或 Codex 订阅用户都会多出 DeepSeek 账单。

本文核验日期为2026 年 10 月 21 日。下面按“谁提供模型与搜索、实际调用了几次、两种费用如何分账”来判断,而不是用客户端名称猜费用。文中代码只供阅读和按需测试;本文未持有读者 API Key,也未执行付费调用或拿到真实账单。

先判断:你的搜索请求到底走哪家后端

Claude Code 和 Codex 是工作界面;它们可以使用各自默认服务,也可以被配置为使用 DeepSeek API。真正与这次 Search/Fetch 请求费有关的,是DeepSeek API 后端及其搜索工具调用。先查配置与账单归属,再判断 11 月 1 日的变化。

你现在的路径是否据此产生 DeepSeek Search/Fetch 账单应核对什么
使用原本的 OpenAI Codex 或 Anthropic Claude Code 账号,没有配置 DeepSeek API不能仅因使用客户端就推断有 DeepSeek 请求费模型提供方、账号账单和实际启用的搜索工具
把 Claude Code 或 Codex 配成 DeepSeek 模型提供方模型请求可能计入 DeepSeek API;Search/Fetch 还要看工具是否被实际调用DeepSeek API 的 base URL、所选模型、搜索开关与用量记录
自己的程序直接向 DeepSeek Search 或 Fetch 端点发请求按官方 Search/Fetch 计价规则检查成功且有结果的请求具体端点、HTTP 状态、返回内容和 DeepSeek 账单
使用第三方网关或聚合平台不能直接把 DeepSeek 官方单价当成第三方收费承诺网关是否代付、是否转发 Search/Fetch、平台账单及服务条款

一个容易漏掉的细节:DeepSeek 的 Codex 接入说明写明,其配置脚本默认关闭内置 Web Search,且该功能仅在特定模型和设置下启用。选中了 DeepSeek 模型,并不能据此认定每个 Codex 任务都调用 Search。Claude Code 接入说明则说明,启用 DeepSeek 后,模型认为需要联网时可调用搜索工具,搜索内容还可能触发额外的模型总结请求。想核对 Claude Code 的安装、认证和 API 账单边界,可先看本站的 Claude Code 国内安装、登录与计费指南;不熟悉 Codex 与 ChatGPT 的关系,可看 Codex 入门说明。

Search 和 Fetch 分别做什么?一次任务可能有多笔请求

Search接收查询词,返回网页结果数组;Fetch接收一个网页 URL,尝试把该页正文转成 Markdown。两者是不同的 JSON 接口,均使用 DeepSeek API Key 的 Bearer 鉴权,端点分别是 POST /v1/tools/search 与 POST /v1/tools/fetch。Search 的 count 控制结果条数,范围为 1–50;它不等于请求次数。Fetch 一次只抓取一个 URL,是否能得到正文受目标站点可用性和访问策略影响。

例如“查三个官方资料并总结”的任务,Agent 可能先改写查询再搜索两次,随后抓取其中四页。按这个假设,它发出了两次 Search、四次 Fetch,而不是“一次任务等于一次搜索”。如果有空结果或抓取失败,还需要分别看哪些请求满足计费条件。不要用模型回复里的“查了很多网页”反推调用次数;最好同时看工具请求日志和提供方账单,尤其是在自动重试、多轮追问或并行子任务中。

11 月 1 日怎么收费?把请求费与模型 Token 费分开

官方两种语言的 Search/Fetch 指南都按成功且有结果的请求列价,而不是按模型 Token 或返回网页条数。中文页各列每 1,000 次 5 元;英文页各列每 1,000 次 0.75 美元。这两个是不同语言页面的标价,官方指南没有在此说明每个账号如何分配结算币种。实际付款币种、税费和账单项目,应以你的 DeepSeek 平台页面为准,不要把“5 元”写成全球所有账号的固定成交价,也不要自行把两页价格混算。

费用计量方法容易误会的地方
Search 请求费HTTP 200 且 results 非空的请求数 × 对应标价count=10 返回十条,不等于十次收费
Fetch 请求费HTTP 200 且返回网页正文的请求数 × 对应标价抓四个 URL 可能是四次请求;空正文或错误不按成功请求计
模型 Token 费模型输入与输出 Token 按所用模型价格表计Search/Fetch 请求费暂免或为零,不代表模型对话与总结免费

官方明确说,请求失败、Search 结果为空和超时不收 Search/Fetch 请求费;count 不影响单次请求价格。仅针对前述使用 DeepSeek API 的 Harness、Claude Code、Codex 服务端工具调用,官方写明现在这部分请求免费、11 月 1 日北京时间零点起收费。直接调用 Search/Fetch 的程序应按页面标价和自己账号的账单核对,不能把特定服务端免请求费期扩展到所有路径。模型本身另见 DeepSeek 模型与价格页。

一个可复核的预算算例

假设 100 个任务,每个任务实际返回结果的 Search 为 2 次、Fetch 为 3 次:合计 200 次 Search、300 次 Fetch,即 500 次可计费工具请求。按英文页标价,工具请求费是 (200 + 300) ÷ 1000 × $0.75 = $0.375;若按中文页列价独立测算,则是 (200 + 300) ÷ 1000 × 5 元 = 2.5 元。两个算式只是分别使用官方页面标价的数学演示,不是汇率换算,也不是任何账户的实付记录。模型输入、输出 Token 与第三方平台费用均未计入。

如果一次任务多抓了网页、重新搜索或子任务并行运行,应把实际成功请求数重新带入算式。QPS 是每秒请求上限,不是免费额度:当前官方列 Search 每账号 100 QPS、Fetch 每账号 25 QPS,Fetch 还受目标域名限速;超过限制返回 429。

发布前或接入前,怎样确认自己的真实提供方

  1. 先看 API 基础地址与密钥来源。DeepSeek 官方 OpenAI 格式地址是 https://api.deepseek.com,Anthropic 格式地址是 https://api.deepseek.com/anthropic。Claude Code 可检查配置中 ANTHROPIC_BASE_URL 是否指向后者;Codex 可检查当前模型提供方及其 base_url。只核来源,不在截图、日志或文章中展示完整 Key。
  2. 再看本次任务是否真的用了网页工具。模型来自 DeepSeek,不等于它调用了 Search/Fetch;模型内部知识回答和 Web Search 是两回事。Codex 如使用 DeepSeek 官方配置脚本,还要核搜索是否另行启用。
  3. 最后看提供方记录。记录测试任务时间、DeepSeek API 账号、模型、Search/Fetch 成功次数及相应账单项。若平台只显示总模型 Token,不要凭总额猜工具请求;向该平台查可导出的用量或收费明细。

先用一个小而明确的查询验证路由,记录结果与错误,再考虑在长期运行的 Agent 中开启自动搜索。若你比较的是“原生 Claude Code、Cursor、Copilot、Kiro 哪个账号有某模型”,本站的 Opus 5.5 编程订阅成本对比讨论的是另一层资格与费用,不能替代 DeepSeek API 工具账单。

最小调用示例:先 Search,再按需 Fetch

以下示例遵循官方接口字段,仅展示调用形状,没有在写稿时执行。实际运行前先在你自己的环境中设置 DEEPSEEK_API_KEY,不要把密钥写进命令历史、仓库或截图;每次有效请求都可能产生费用。先只做 Search,核对返回网址,再决定是否抓取其中一页。

curl:搜索一次

curl -sS -X POST https://api.deepseek.com/v1/tools/search \
  -H "Authorization: Bearer $DEEPSEEK_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"DeepSeek Search Fetch 官方文档","count":3,"need_content":false}'

query 必填,限 1–128 个 Unicode 字符;count 不填默认为 10,范围 1–50。这里设为 3 只是减少阅读噪音,不会把一次请求变成“三次”或改变单次请求价。正常但无匹配时,响应仍可能是 HTTP 200、results: [],按现行计费说明不收这次工具请求费。

Python:抓取一条你已核对的网页

import os
import requests

url = "https://example.com/article"  # 换成你确认要抓取的公开网页
response = requests.post(
    "https://api.deepseek.com/v1/tools/fetch",
    headers={"Authorization": "Bearer " + os.environ["DEEPSEEK_API_KEY"]},
    json={"url": url},
    timeout=20,
)
response.raise_for_status()
page = response.json()
print(page.get("title", ""))
print(page.get("content", "")[:500])

Fetch 的 url 要是含主机名的 HTTP/HTTPS 地址,不含用户名或密码,长度不能超过官方限制;即使 URL 有效,也可能因目标站点拒绝抓取、内容类型不支持或没有可提取正文而失败。这里的 example.com 是占位地址,代码不代表已经成功抓到内容。

报错时先分流,不要盲目重试

返回状态先检查下一步
400 / 401JSON 字段、请求头、Key 是否缺失或无效修正请求;不要在公开日志里打印 Key
402DeepSeek API 余额是否不足按实际账号账单处理后再试;ChatGPT 或 Claude 订阅不能当 DeepSeek API 余额
403 / 404(Fetch)安全策略、目标 URL、目标站点响应、正文可提取性换合法且可访问的目标;不靠反复请求绕过站点限制
408 / 429 / 5xx超时、账号或域名限速、临时服务故障等待后有限次重试;429 应降低并发

上表对应官方英文 Search/Fetch 错误说明。HTTP 200 也要检查返回内容:Search 空数组不等于联网已找到可靠资料,Fetch 空正文也不能直接交给模型总结。搜索结果里的日期、站点与正文仍需人工验源,接口返回本身不保证事实正确。

FAQ:常见账单与国内开通问题

2026 年 11 月 1 日后,所有 Claude Code 和 Codex 用户都会被 DeepSeek 收搜索费吗?

不会据此一概而论。官方限定的是使用 DeepSeek API的 DeepSeek Harness、Claude Code、Codex 中已访问 Search/Fetch 的服务端工具调用。仍使用原生提供方、没有 DeepSeek API 路由,或任务根本没有调用该工具,不能仅凭客户端名称推定这笔 DeepSeek 费用。

Search/Fetch 请求免费期间,DeepSeek 模型 Token 也免费吗?

不是。免请求费说明限定 Search/Fetch 工具调用;模型输入和输出 Token 的价格在独立的模型价格页列出。网页内容如果被送回模型阅读、总结,还可能增加后续模型 Token 用量。

中文页写每千次 5 元、英文页写 0.75 美元,我实际付哪个?

这两项均来自当前官方页面,但指南没有在同一处给出所有账户币种分配规则。不要用自行换算结果替代付款页;登录 DeepSeek 平台核本账号结算币种、用量和账单,再按相应规则估预算。

国内开通 ChatGPT Plus 或 Claude Pro,能用来支付 DeepSeek Search/Fetch 吗?

不能把三种账户余额混在一起。若你的需求其实是 ChatGPT 或 Claude 的订阅,可分别看本站的 国内开通 ChatGPT Plus 指南和 国内开通 Claude Pro 指南,并先核官方地区、账号与支付资格。作者另有自营的收费开通服务说明,服务范围和退款条件以该页为准;它不是 DeepSeek API 余额服务,不能解决本文的 Search/Fetch 账单问题,也不代表与 DeepSeek、OpenAI 或 Anthropic 有官方合作。

来源与更新边界

本文于 2026 年 10 月 21 日核对 DeepSeek 更新日志、中文 Search/Fetch 指南、英文指南、模型价格页及 Claude Code/Codex 接入页。11 月 1 日生效后,计费说明、限速、账号币种与工具默认设置都可能调整;请在实际接入和付款前再核官方页面与本账号账单。本文没有调用付费接口、没有测试搜索质量,也不提供“每个编程任务固定花费”的保证。

Continue reading

相关推荐

查看全部文章
01 Cursor 还能用 OpenAI 模型吗?11 月 12 日变更、BYOK 与 Codex 迁移指南 2026-08-31 02 用 AI 写代码,到底该选 Copilot、Cursor、Claude Code 还是 Codex? 2026-06-01 03 Django CKEditor 5 实战:接入、图片上传、按日期存储与生产环境避坑 2026-03-19 04 Mac安装Homebrew教程:解决brew安装失败(国内镜像安装方法) 2026-03-05