大模型网摘Search & Fetch API 详解：端点、参数、计费与免费期
10 月 17 日起，DeepSeek 把自研搜索引擎开放为两个原始 JSON API，为智能体与 RAG 应用提供实时网页内容。本文依据官方 API 文档整理端点、参数与计费规则。
端点与鉴权
两个端点与对话 API 共用基础地址 https://api.deepseek.com 与 Bearer 鉴权：
- Search：
POST /v1/tools/search——按查询返回结构化网页结果； - Fetch：
POST /v1/tools/fetch——抓取单个网页并转为 Markdown。
Search 请求参数
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| query | string | 是 | 1–128 个 Unicode 字符，不能全为空白，支持查询运算符 |
| count | integer | 否 | 返回结果数，1–50，默认 10 |
| need_content | boolean | 否 | 是否附带页面内容 |
| ori_question | string | 否 | 触发搜索的原始问题（1–128 字符），用于改善查询理解 |
返回结果包含 title、url 与 summary（need_content 为 true 时附正文），非常适合先搜后取的两段式流程，上手代码见Python 实战教程。
计费规则
两个端点均按 0.75 美元/千次成功调用计费，互不影响配额。一个值得利用的窗口期：通过 DeepSeek Harness、Claude Code、Codex 的服务端工具调用 Search/Fetch，截至 2026 年 10 月 31 日 16:00（UTC）免费，此后开始计费。搭配对话模型时，把搜索结果摘要而非全文送入上下文，并开启上下文缓存，可以显著压低 token 开销，做法参考API 最佳实践。
与模型 token 计费的关系
Search/Fetch 按调用次数计费，与模型的 token 单价（deepseek-flash 峰时输出 1.20 美元/百万、谷时半价）相互独立。如果你的用量集中在非高峰时段，模型侧还能再省一半，峰谷规则详见峰谷计价指南。工具侧的接入方式对比见编码 Agent 工具速览。