DeepSeek Search
最近更新:2026年11月22日
DeepSeek 联网搜索(deepseek/deepseek-search)的规格参数、结果结构、计费规则与调用示例。
DeepSeek Search(官方端点 /v1/tools/search)提供低延迟的实时联网搜索,支持原始问题上下文语义重排(ori_question)、地域定位(localization)以及可选网页正文同步抓取(need_content)。
该工具通过 Web Search(POST /v1/tools/search)端点调用,使用 Authorization: Bearer <key> 鉴权。
工具规格
| 属性 | 说明 |
|---|---|
| 模型 ID | deepseek/deepseek-search |
| 可用别名 | deepseek-search |
| 支持能力 | 实时联网搜索、最多 50 条结果、语义重排得分(rerank_score)、站点权威度(authority)、可选网页全文(need_content) |
| 计费方式 | 按成功请求次数计费;请求失败或返回空结果列表时不计费;实时单价见模型详情页 |
| 流式输出 | 不支持 |
POST
https://gateway.amux.ai/v1/tools/search鉴权
headerAuthorizationstring必填Bearer <你的 Amux AI 密钥> 在控制台创建的 Amux AI API 密钥。
Content-Typestring必填默认 "application/json"固定为 application/json。
请求
application/jsonmodelstring必填模型标识,支持规范 ID deepseek/deepseek-search 或裸名别名 deepseek-search。
querystring必填搜索关键词(1–128 个字符,同时兼容别名 q)。
countinteger默认 10期望返回的搜索结果数量(1–50,默认 10)。
ori_questionstring可选的原始用户问题(最多 128 个字符),用于辅助语义重排与摘要相关性。
localizationstring可选的地域定位 IP 地址字符串,用于优化本地化搜索排序。
need_contentboolean默认 false是否同步抓取各条结果的网页全文;设为 true 时在每条结果的 content 中返回提取正文。
响应
200response搜索成功。
400response请求参数不合法。
402response工作区可用余额不足。
使用说明
- 默认
need_content: false,仅返回标题、URL、语义摘要与重排得分,延迟更低;需要一并获取网页全文时传入need_content: true。 - 搭配多轮对话或 Agent 检索时,将用户原始提问传入
ori_question(最多 128 字符)有助于提升语义重排相关性。 - 若需对单条高价值链接进一步抓取完整正文,可搭配 DeepSeek Fetch 使用。
错误处理
错误响应采用 OpenAI 标准结构。缺少 query 或 count 超出 1–50 范围返回 400 invalid_request;完整错误码见错误与重试。
cURL
curl https://gateway.amux.ai/v1/tools/search \
-H "Authorization: Bearer $AMUX_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "deepseek/deepseek-search",
"query": "DeepSeek API release notes",
"count": 5,
"need_content": false
}'{
"object": "list",
"model": "deepseek/deepseek-search",
"results": [
{
"title": "DeepSeek API Docs",
"url": "https://api-docs.deepseek.com/",
"site_name": "DeepSeek",
"site_icon": "https://api-docs.deepseek.com/favicon.ico",
"authority": 0.92,
"rerank_score": 2.35,
"date": "2026-11-20",
"summary": "Official documentation for DeepSeek API models and tools.",
"snippet": "Official documentation for DeepSeek API models and tools.",
"content": "# DeepSeek API Docs"
}
]
}