---
title: "DeepSeek 搜索 API 10 月 17 日开放：curl 调用示例，11 月 1 日起每千次 0.75 美元"
description: "DeepSeek 在 10 月 17 日开放 Search 和 Fetch API，各 0.75 美元/千次成功请求。本文给出 curl 示例、错误码处理表和月成本算法，并说明 11 月 1 日起 Claude Code、Codex 里的搜索调用也要计费。"
url: https://cdnping.org/blog/deepseek-search-fetch-api-pricing
language: zh-CN
published: 2026-10-19
category: "服务动态"
tags: ["DeepSeek","搜索API","Fetch API","API计费","RAG","Claude Code"]
source: cdnping.org
license: Free to quote and summarize with a link to the url above.
---
# 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 日页面内容，具体以[官方搜索指南](https://api-docs.deepseek.com/guides/search)为准。

## 发生了什么？

据 [10 月 17 日的官方公告](https://api-docs.deepseek.com/news/news261017)，Search & Fetch API 在同一天的模型更新公告里发布。模型本身的变化见我们的另一篇文章：[DeepSeek V4.1-Flash-1017 上线：deepseek-flash 换了新权重，开发者要不要改代码](/blog/deepseek-v4-1-flash-1017-update)。

两个接口的分工：

- 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` 可以放用户的原始问题，帮助理解查询意图。

```bash
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，不能带用户名密码。

```bash
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 日起怎么收费？

计费规则有三点：

1. 单价都是 0.75 美元/千次成功请求，`count` 不影响价格。
2. 只有返回 HTTP 200 且有结果才计费：Search 的 `results` 非空，Fetch 取到了页面内容。失败、空结果、超时都不收费。
3. 通过 DeepSeek Harness、Claude Code、Codex 的服务端工具调用目前免费，官方说明按次计费从北京时间 2026 年 11 月 1 日 00:00 开始，即 UTC 10 月 31 日 16:00，价格以[官方价格页](https://api-docs.deepseek.com/quick_start/pricing)为准。

### 月成本怎么估？

月成本 ≈（月 Search 成功次数 + 月 Fetch 成功次数）÷ 1000 × 0.75 美元。

举个假设的例子：一个 agent 每天平均成功搜索 1000 次、抓取 2000 页，按 30 天算，共 90000 次，约 67.5 美元。这只是演示算法，你的实际次数要用日志统计。注意 agent 的一次任务往往会触发多次搜索和抓取，建议先在日志里按接口记录成功的 200 响应数，再乘单价。

## 用 Claude Code 或 Codex 接 DeepSeek 的人要注意什么？

如果你的搜索走的是上述工具的服务端调用，11 月 1 日前不收费，之后会单独计费，不再包含在模型 token 费用里。接入方式可以参考：[Claude Code 接自定义接口地址](/blog/claude-code-custom-base-url-third-party)。对账时按“token 费用”和“搜索/抓取费用”分开看，核对方法见[API 计费不对怎么查](/blog/relay-billing-token-mismatch)。

建议在 11 月 1 日前做三件事：

- 统计最近一周的搜索和抓取次数，用上面的公式估一个月成本。
- 在应用里给搜索设置次数上限，避免 agent 循环调用。
- 请求遇到 429 时做指数退避，别在 5 QPS 之外硬撑并发。

## 怎么盯住价格和可用性变化？

DeepSeek 的价格页和更新日志可以在 cdnping 的[官网动态](/changes)里查看逐行变动，也支持 RSS。API 入口是否可达，看 [DeepSeek API 状态](/status/deepseek)，cdnping 每 5 分钟从 Cloudflare 边缘探测官方入口。需要判断是不是自己这边的问题，可以对照[怎么看 AI 服务状态页](/blog/how-to-read-ai-status-pages)，或者直接看 [DeepSeek 挂了吗](/down/deepseek)。注意，状态探测只覆盖入口可达性，不代表搜索接口本身的成功率。

## 参考来源

- [DeepSeek Search & Fetch API 官方指南](https://api-docs.deepseek.com/guides/search)
- [DeepSeek 2026-10-17 公告](https://api-docs.deepseek.com/news/news261017)
- [DeepSeek 模型与价格](https://api-docs.deepseek.com/quick_start/pricing)