DeepSeek 搜索 API 10 月 17 日开放：curl 调用示例，11 月 1 日起每千次 0.75 美元
DeepSeek 在 2026 年 10 月 17 日向所有开发者开放了基于自研搜索引擎的 Search 和 Fetch API。两个接口都按“成功请求”计费，每千次 0.75 美元；通过 DeepSeek Harness、Claude Code、Codex 的服务端工具调用目前免费，北京时间 2026 年 11 月 1 日 00:00 起开始按次计费。
以下内容均来自 DeepSeek 官方文档，截至 2026 年 10 月 17 日页面内容，具体以官方搜索指南为准。
发生了什么？
据 10 月 17 日的官方公告，Search & Fetch API 在同一天的模型更新公告里发布。模型本身的变化见我们的另一篇文章：DeepSeek V4.1-Flash-1017 上线：deepseek-flash 换了新权重，开发者要不要改代码。
两个接口的分工：
- Search：
POST https://api.deepseek.com/v1/tools/search，返回结构化的搜索结果。 - Fetch：
POST https://api.deepseek.com/v1/tools/fetch，抓取单个网页并返回 Markdown。
都使用 Authorization: Bearer <DeepSeek API Key> 鉴权，请求体是 JSON。
怎么调用？
Search
query 必填，1–128 个字符。count 为 1–50，默认 10。need_content 默认 false，设为 true 才会返回页面正文。ori_question 可以放用户的原始问题，帮助理解查询意图。
curl https://api.deepseek.com/v1/tools/search \
-H "Authorization: Bearer $DEEPSEEK_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query": "Cloudflare Workers site:developers.cloudflare.com after:2026-01-01", "count": 5}'
查询里支持的语法有：site:、-site:（多个站点用 OR 连接）、-词、"短语"、lang:zh,en、after:、before:，可以组合使用。
返回的 results 数组里，每条有 title、url、snippet（约 100–200 字）、summary（约 600–800 字，面向模型）、rerank_score（0–3，1.5 及以上为高质量）、authority（0–4，-1 表示未知）、date 等字段。做 RAG 时可以先按 rerank_score 过滤，再决定要不要取全文。
Fetch
只有一个 url 字段，不超过 8192 字符，必须是 HTTP 或 HTTPS，不能带用户名密码。
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。能否抓到取决于目标站点的可用性和访问策略。
出错了怎么处理？
按官方的重试建议，状态码处理如下：
| 状态码 | 含义 | 怎么做 |
|---|---|---|
| 400 | 请求头或请求体不合法 | 检查 JSON 和字段取值，不要原样重试 |
| 401 | Key 缺失或无效 | 检查 Key |
| 402 | 余额不足 | 先充值再重试 |
| 403 | Fetch 被安全策略拒绝 | 换目标，不要重试 |
| 404 | Fetch 没取到可用内容 | 没取到可用内容，换目标 |
| 408 | 读取请求体超时 | 等待后退避重试 |
| 413 | 请求体过大 | 缩小请求 |
| 429 | 超过 QPS 限制 | 退避重试，并降低并发 |
| 500 / 504 | 服务端错误或下游超时 | 退避重试 |
限流方面：Search 和 Fetch 各有 5 QPS 的账号级限制，按账号计算，两者互相独立。Fetch 另有按域名的 QPS 限制，同样返回 429。
11 月 1 日起怎么收费？
计费规则有三点：
- 单价都是 0.75 美元/千次成功请求，
count不影响价格。 - 只有返回 HTTP 200 且有结果才计费：Search 的
results非空，Fetch 取到了页面内容。失败、空结果、超时都不收费。 - 通过 DeepSeek Harness、Claude Code、Codex 的服务端工具调用目前免费，官方说明按次计费从北京时间 2026 年 11 月 1 日 00:00 开始，即 UTC 10 月 31 日 16:00，价格以官方价格页为准。
月成本怎么估？
月成本 ≈（月 Search 成功次数 + 月 Fetch 成功次数）÷ 1000 × 0.75 美元。
举个假设的例子：一个 agent 每天平均成功搜索 1000 次、抓取 2000 页，按 30 天算，共 90000 次，约 67.5 美元。这只是演示算法，你的实际次数要用日志统计。注意 agent 的一次任务往往会触发多次搜索和抓取，建议先在日志里按接口记录成功的 200 响应数，再乘单价。
用 Claude Code 或 Codex 接 DeepSeek 的人要注意什么？
如果你的搜索走的是上述工具的服务端调用，11 月 1 日前不收费，之后会单独计费，不再包含在模型 token 费用里。接入方式可以参考：Claude Code 接自定义接口地址。对账时按“token 费用”和“搜索/抓取费用”分开看，核对方法见API 计费不对怎么查。
建议在 11 月 1 日前做三件事：
- 统计最近一周的搜索和抓取次数，用上面的公式估一个月成本。
- 在应用里给搜索设置次数上限，避免 agent 循环调用。
- 请求遇到 429 时做指数退避，别在 5 QPS 之外硬撑并发。
怎么盯住价格和可用性变化？
DeepSeek 的价格页和更新日志可以在 cdnping 的官网动态里查看逐行变动，也支持 RSS。API 入口是否可达，看 DeepSeek API 状态，cdnping 每 5 分钟从 Cloudflare 边缘探测官方入口。需要判断是不是自己这边的问题，可以对照怎么看 AI 服务状态页，或者直接看 DeepSeek 挂了吗。注意，状态探测只覆盖入口可达性，不代表搜索接口本身的成功率。
