Web Search
最近更新:2026年11月22日
统一联网搜索端点,按模型标识路由至对应搜索引擎并返回结构化结果列表与可选网页正文。
统一的同步联网搜索端点,按 model 字段路由至对应上游搜索引擎(当前支持 Jina Search 与 DeepSeek Search),将不同厂商的搜索请求与响应归一化为一致的 JSON 结构。
POST
https://gateway.amux.ai/v1/tools/search鉴权
headerAuthorizationstring必填Bearer <你的 Amux AI 密钥> 在控制台创建的 Amux AI API 密钥。
Content-Typestring必填默认 "application/json"固定为 application/json。
请求
application/jsonmodelstring必填搜索模型规范 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
}
}