Amux AI

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> 鉴权。

工具规格

属性说明
模型 IDdeepseek/deepseek-search
可用别名deepseek-search
支持能力实时联网搜索、最多 50 条结果、语义重排得分(rerank_score)、站点权威度(authority)、可选网页全文(need_content)
计费方式按成功请求次数计费;请求失败或返回空结果列表时不计费;实时单价见模型详情页
流式输出不支持
POSThttps://gateway.amux.ai/v1/tools/search

鉴权

header
Authorizationstring必填

Bearer <你的 Amux AI 密钥> 在控制台创建的 Amux AI API 密钥。

Content-Typestring必填默认 "application/json"

固定为 application/json。

请求

application/json
modelstring必填

模型标识,支持规范 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"
    }
  ]
}