DeepSeek 联网搜索 API 国内怎么接？地址、价格与调用示例（2026-10）

2026-10-23 · 7 分钟阅读

DeepSeek联网搜索 APISearch APIRAGAPI 接入

先给答案：DeepSeek 的联网搜索能力已经以 API 形式开放，国内可以直接调用 POST https://api.deepseek.com/v1/tools/search，另有 POST https://api.deepseek.com/v1/tools/fetch 用来抓取单个网页。价格不是按 token，而是按成功请求计费：搜索和抓取都是 0.75 美元 / 1000 次，约合每次 0.005 元人民币。在 DeepSeek Harness、Claude Code 或 Codex 里通过服务端工具调用触发的 Search / Fetch，目前免费，但到北京时间 2026 年 11 月 1 日 00:00 结束——自己拿 Key 直连 API 不在这个免费窗口里。

这篇按「它是什么 → 国内怎么申请 → 多少钱 → 怎么调 → 和站内联网搜索怎么选」讲，示例和字段都按 2026-10-22 的官方文档核对过。

先分清：它是搜索工具，不是聊天模型

DeepSeek 这次开放的是两个只读工具：

Search：给一个查询词，返回一组网页结果，可以带正文；
Fetch：给一个 URL，把网页内容取回来转成 Markdown。

两者都不负责回答。你要自己用一个大模型来拆问题、改查询词、读结果、判断什么时候停。所以它适合的是 Agent、RAG、内容聚合、监控这类「需要实时网页上下文」的程序，不是给普通用户直接聊天的入口。

请求头和普通 DeepSeek API 一样，用 Authorization: Bearer <API Key>。

国内能直接用吗？Key 在哪申请

可以。接口域名是 api.deepseek.com，国内网络可直连，不需要额外代理。步骤是：

打开 DeepSeek 开放平台，注册账号；
在 API Keys 页面创建一个 Key，复制保存（只显示一次）；
在余额页充值。Search / Fetch 和聊天模型共用同一个账户余额。

如果你只是想在浏览器里用带联网的 DeepSeek，不用申请 Key，直接看下一节的对比：站内已经自带联网搜索插件。

价格：按成功请求，不按 token

官方定价很直接：

API	单价
Search	0.75 美元 / 1000 次成功请求
Fetch	0.75 美元 / 1000 次成功请求

几个容易误读的细节：

只对成功请求计费。 返回 HTTP 200 且有结果才算：Search 必须有非空 results，Fetch 必须取到页面正文。失败、空结果、超时都不收费。
count 不影响价格。 一次要 1 条还是 50 条，都是同一次请求的钱。
免费窗口只覆盖特定工具。 通过 DeepSeek Harness、Claude Code、Codex 触发的服务端工具调用目前免费，2026-11-1 00:00（北京时间）起按请求计费。自己写代码直连 API 的，从第一次调用就开始计费。
按账户限额。 Search 100 QPS、Fetch 25 QPS，两条额度独立；限额按账号算，多建几个 Key 不会扩容。

按 0.75 美元/1000 次估算，1 万次搜索约 7.5 美元。对每天跑几千次查询的 Agent 来说不算贵，但前提是查询本身有效——低质量结果照样收费，还会把错误带进下一步。

最小调用示例

搜索：

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

Python 版本：

import os, requests

resp = requests.post(
    "https://api.deepseek.com/v1/tools/search",
    headers={"Authorization": f"Bearer {os.environ['DEEPSEEK_API_KEY']}"},
    json={"query": "DeepSeek V4 发布", "count": 5, "need_content": True},
    timeout=30,
)
resp.raise_for_status()
for item in resp.json()["results"]:
    print(item["title"], item["url"])
    print(item["summary"])

抓取单个网页：

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"}'

Search 的返回是 results 数组，常用字段有 title、url、snippet、summary、content、site_name、date、authority、rerank_score。两个排序信号值得用起来：

rerank_score 范围 0~3，综合相关性、权威性和时效性，1.5 及以上算高质量结果；
authority 范围 0~4，-1 表示未知，3 及以上算高权威来源。

与其无脑取前 N 条，不如先按这两个字段过滤，再交给模型读。

查询语法：把搜索范围收窄

query 支持一组操作符，直接拼在查询词里：

写法	作用
`site:github.com`	只搜某个站；多个 `site:` 用空格分隔再加 `OR`
`-site:example.com`	排除某个站
`-advertisement`	排除包含某个词的页面
`"exact phrase"`	精确匹配短语
`-"exact phrase"`	排除某个短语
`lang:zh,en`	限定语言
`after:2025-01-01` / `before:2026-06-01`	限定发布时间

例如查最近一年的官方文档和代码仓库：

{
  "query": "DeepSeek site:github.com OR site:huggingface.co lang:en after:2025",
  "count": 10
}

另外 need_content 默认是 false，这时 content 返回空字符串；需要正文就把 true。ori_question 可以填用户的原始问题，帮助搜索端理解意图；count 取值 1~50，默认 10。

报错怎么处理

错误格式和 OpenAI 兼容，处理规则只有几条：

408 / 429 / 5xx：等一等再重试；
402：余额不足，先充值；
其他 4xx：改请求，别原样重试。

429 尤其要注意：限额按账号算，不是按 Key，所以「换个 Key 继续打」没有用，只能退避。

它和站内「联网搜索」有什么区别？

如果你只是想让 AI 帮你查资料、回答问题，不需要写代码，也不该从这套 API 开始：

	DeepSeek Search / Fetch API	站内联网搜索
面向谁	开发者、Agent、RAG 程序	普通用户直接聊天
是否需要写代码	是	否
是否需要 API Key	是	否
返回到哪	结构化 JSON，自己接模型	直接在对话里给答案和来源
费用	按成功请求付费	登录送免费额度，站内插件不额外收费
国内访问	可直连	可直连

站内 DeepSeek 已经自带「搜索引擎」插件，点亮就能联网，不用申请 Key、不用自己写检索循环。具体怎么开、什么时候该开、怎么让它引用来源，可以看DeepSeek 联网搜索使用指南。

三个容易踩的坑

把免费窗口当成 API 免费。 免费只覆盖 Harness / Claude Code / Codex 的服务端工具调用，直连 tools/search 从第一笔就计费，11 月 1 日之后连前者也开始收费。
只看价格不看结果质量。 空结果免费，但低质量结果照样收一次请求的钱，还可能让模型基于错误材料继续推理。先过滤 authority 和 rerank_score，比省那几分钱重要。
以为 Fetch 什么都能取。 目标站返回 403、404、需要登录、内容是图片或非可提取格式时，Fetch 会失败或只拿到空正文；这不是 Key 的问题，换 URL 或改用浏览器方案更实际。

一句话总结

要自建 Agent / RAG、需要结构化搜索结果，就用 DeepSeek Search API：国内直连 api.deepseek.com，0.75 美元/1000 次成功请求，记得 11 月 1 日前把免费窗口的影响算进去；只是自己查资料，直接用站内带联网的 DeepSeek，登录就有免费额度，不用碰 API。想先弄清 DeepSeek 各版本怎么分工，可以对照V4.1 Flash、V4 Pro、R1 的区别。