Amux AI

Web Search

最近更新:2026年11月22日

统一联网搜索端点,按模型标识路由至对应搜索引擎并返回结构化结果列表与可选网页正文。

统一的同步联网搜索端点,按 model 字段路由至对应上游搜索引擎(当前支持 Jina Search 与 DeepSeek Search),将不同厂商的搜索请求与响应归一化为一致的 JSON 结构。

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 或别名(如 jina/jina-search、deepseek/deepseek-search)。

querystring必填

搜索关键词字符串。

countinteger

期望返回的搜索结果条数(1–50)。

need_contentboolean默认 true

是否抓取并返回各条结果的网页全文;设为 false 仅返回标题、链接与摘要。

ori_questionstring

可选的原始用户问题上下文,用于语义重排相关性(DeepSeek Search 支持)。

localizationstring

可选的地域定位 IP 地址字符串,用于优化本地化搜索排序(DeepSeek Search 支持)。

sitestring | array<string>

可选的站点域名过滤(单个域名或域名数组)。

countrystring

可选的两位国家/地区代码(如 US、CN)。

languagestring

可选的界面语言代码(如 en、zh-cn)。

no_cacheboolean默认 false

是否绕过上游缓存实时检索。

token_budgetinteger

可选的输出 token 上限预算。

响应

200response

搜索成功。

400response

请求参数无效或目标模型不支持搜索端点。

402response

工作区账户余额不足。

协议特性说明

  • 统一 JSON 接口:调用方只需更换 model 即可在不同搜索供应商间切换,无需分别适配各家私有请求头或返回字段。
  • 正文与摘要可选:默认抓取网页正文;若只需快速获取标题、URL 与摘要片段,可将 need_content 设为 false。
  • 同步非流式:不支持 stream: true;单次响应体上限 16 MB。

错误处理

错误响应统一采用 OpenAI 标准错误结构。缺少 query、count 越界或目标模型不支持搜索均返回 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": "jina/jina-search",
    "query": "latest AI embedding models",
    "count": 3,
    "need_content": false
  }'
{
  "object": "list",
  "model": "jina/jina-search",
  "results": [
    {
      "title": "Example Result",
      "url": "https://example.com",
      "snippet": "Concise summary of the page.",
      "summary": "<string>",
      "content": "# Example Result",
      "site_name": "<string>",
      "authority": 0,
      "rerank_score": 0,
      "date": "<string>",
      "published_time": "<string>"
    }
  ],
  "usage": {
    "total_tokens": 10000
  }
}