DeepSeek(搜索与网页抓取,仅中国区)
平台提供两个 DeepSeek 端点:Search 拿网页搜索结果,Fetch 把单个网页转成 Markdown 正文。两者互相独立,可以单独调用,也可以串起来用(Search 找页面 → Fetch 取正文 → 喂给 LLM)。
官方文档:DeepSeek 搜索与抓取 ↗
通用约定
- 仅在 中国区 提供,其他区域调用返回
404(错误码 1003)。 - 两个端点都是
POST+ JSON body,只需要Authorization: Bearer $TURING_API_KEY一个头。 - 每个端点只接受下面表格列出的字段,出现表外字段会直接返回
422,请求不会发出。 - 响应中值为
null的字段不会出现在返回里。
Search
- 端点:
POST /proxy/deepseek/search - 必填参数:
query
| 参数 | 类型 / 默认值 | 说明 |
|---|---|---|
query | string,必填 | 查询词,1–128 字符,不能全是空白。支持下方的检索语法 |
count | int,默认 10 | 返回结果数,1–50。只影响条数,不影响价格 |
ori_question | string | 用户的原始问题,1–128 字符,帮助理解检索意图 |
localization | string | 一个 IP 地址(IPv4 / IPv6),用于优先返回该地区的本地化结果 |
need_content | bool,默认 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
| 参数 | 类型 / 默认值 | 说明 |
|---|---|---|
url | string,必填 | 要抓取的网页,≤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 次;正文为空不计费 |
失败的请求——参数校验不通过、上游报错、响应无效——都不计费。
限流与错误