跳到主要内容

DeepSeek(搜索与网页抓取,仅中国区)

平台提供两个 DeepSeek 端点:Search 拿网页搜索结果,Fetch 把单个网页转成 Markdown 正文。两者互相独立,可以单独调用,也可以串起来用(Search 找页面 → Fetch 取正文 → 喂给 LLM)。

官方文档:DeepSeek 搜索与抓取 ↗

通用约定​

  • 仅在 中国区 提供,其他区域调用返回 404(错误码 1003)。
  • 两个端点都是 POST + JSON body,只需要 Authorization: Bearer $TURING_API_KEY 一个头。
  • 每个端点只接受下面表格列出的字段,出现表外字段会直接返回 422,请求不会发出。
  • 响应中值为 null 的字段不会出现在返回里。
  • 端点:POST /proxy/deepseek/search
  • 必填参数:query
参数类型 / 默认值说明
querystring,必填查询词,1–128 字符,不能全是空白。支持下方的检索语法
countint,默认 10返回结果数,1–50。只影响条数,不影响价格
ori_questionstring用户的原始问题,1–128 字符,帮助理解检索意图
localizationstring一个 IP 地址(IPv4 / IPv6),用于优先返回该地区的本地化结果
need_contentbool,默认 false是否在每条结果的 content 里带上网页正文

query 支持的检索语法,可以在同一条查询里组合使用:

写法作用
site:example.com只搜指定站点,多个站点用 OR 连接
-site:example.com排除指定站点
"精确短语"精确匹配短语
-关键词 / -"短语"排除包含该关键词或短语的结果
lang:zh,en限定结果语言,多个语言用逗号分隔
after:2026-01-01 / before:2026限定发布时间,取值为年份或 YYYY-MM-DD
curl $TURING_BASE_URL/proxy/deepseek/search \
-H "Authorization: Bearer $TURING_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"query": "DeepSeek API site:api-docs.deepseek.com",
"count": 3
}'

响应节选:

{
"results": [
{
"title": "DeepSeek-V4 预览版:迈入百万上下文普惠时代 | DeepSeek API Docs",
"url": "https://api-docs.deepseek.com/zh-cn/news/news260424/",
"snippet": "API 访问 目前,DeepSeek API 已同步上线 V4-Pro 与 V4-Flash……",
"summary": "即日起登录官网 chat.deepseek.com 或官方App,即可与最新的 DeepSeek-V4 对话……",
"content": "",
"site_name": "DeepSeek",
"site_icon": "https://cdn.deepseek.com/site-icons/deepseek.com",
"date": "2026-04-23T16:00:00+00:00",
"authority": 3,
"rerank_score": 2.26
}
]
}

顶层只有 results 一个数组;没有命中时返回空数组。每条结果的字段:

字段说明
title / url网页标题与地址
snippet短摘要,通常 100–200 字,适合在界面上展示
summary长摘要,通常 600–800 字,适合直接喂给模型
content网页正文;need_content 为 false 或页面没有正文时为空字符串
site_name / site_icon站点名称与图标地址,未知时不返回
date发布时间(UTC,RFC 3339),未知时不返回
authority站点权威度,0–4,3 及以上为高权威;-1 表示未知
rerank_score与查询的相关度,0–3,1.5 及以上可视为高质量结果

Fetch​

把一个网页抓下来转成 Markdown,适合拿到 Search 的 URL 后读取完整正文。

  • 端点:POST /proxy/deepseek/fetch
  • 必填参数:url
参数类型 / 默认值说明
urlstring,必填要抓取的网页,≤8192 字符;必须是带主机名的 http(s) 地址,不能包含账号密码
curl $TURING_BASE_URL/proxy/deepseek/fetch \
-H "Authorization: Bearer $TURING_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"url": "https://api-docs.deepseek.com/"
}'

响应节选:

{
"title": "Your First API Call | DeepSeek API Docs",
"content": "……# Your First API Call\n\nThe DeepSeek API uses an API format compatible with OpenAI/Anthropic……"
}
字段说明
title网页标题,没有时为空字符串
content网页正文,Markdown 格式

能否抓取取决于目标站点是否可访问及其访问策略。目标页面不可达、被站点拦截、内容类型不支持或提取不出正文时,请求失败并返回 502。

计费​

按次计价,Search 和 Fetch 单价相同,均为 ¥0.005 / 次(¥5 / 千次)。只有成功且有结果的请求才计费:

端点计费规则
Search返回至少 1 条结果时计 1 次,与 count 和实际条数无关;返回空数组不计费
Fetch返回网页正文时计 1 次;正文为空不计费

失败的请求——参数校验不通过、上游报错、响应无效——都不计费。

限流与错误
  • 限流:Search / Fetch 各自独立计数,默认每个端点 480 次 / 小时(企业客户额度另行核定)。配额与限流在请求发出之前校验。
  • 404(错误码 1003):在中国区以外的区域调用。
  • 422:请求体没通过字段或取值校验,请求未发出。
  • 429(错误码 3091):触发上游限流,稍等后重试。短时间内频繁 Fetch 同一站点也可能触发。
  • 502(错误码 3090):上游报错、Fetch 抓不到可用正文、响应格式非法,或响应体超过 10 MB。返回统一的错误信息,不透传上游的原始错误内容;排查请带上 X-Turing-Trace-Id。

错误码含义见 错误码参考,限流策略见 速率限制。

自助排查