胜算云 胜算云 文档中心 ↗ 精益社区

模型联网接口

用同一把胜算云 Key 调用模型的联网能力:联网搜索(Bocha / DeepSeek / Tavily 三家共用 POST /v1/tools/search,用 model 选择)与网页抓取(deepseek/fetch 把网页正文转成 Markdown)。响应结构统一,可在 Agent 里「先搜索、再抓取正文」串联使用。

BASE URLhttps://router.shengsuanyun.com/api
认证方式Authorization: Bearer YOUR_API_KEY
仅存 localStorage 🗝 控制台获取 Key → ✓ 已保存

端点列表

三家联网搜索怎么选

三个服务共用 POST /v1/tools/search 与同一套响应结构,只靠 model 区分,切换服务商不需要改代码结构。

服务model条数参数专有参数
Bochabocha/bocha-web-searchcount(1~50)summary 额外摘要、freshness 时间筛选、include / exclude 站点限定与排除
DeepSeekdeepseek/searchcount(1~50)ori_question 原始问题、localization、need_content 返回正文
Tavilytavily/tavily-searchmax_results(0~20)search_depth 搜索深度、topic / days / language 筛选、include_domains / exclude_domains、need_content

三家的关键词参数都叫 query,但条数参数不同:Tavily 用 max_results,另外两家用 count;三家都有 need_content 这一项(字段名一致,返回正文的能力以服务商实际支持为准)。

响应字段说明 · 联网搜索

字段类型说明
resultsarray结果列表;无结果时为 []
results[].titlestring网页标题
results[].urlstring网页链接,可直接交给 POST /v1/tools/fetch 抓取正文
results[].snippetstring网页摘要片段;不同服务商可能省略
results[].summarystring额外生成的摘要;仅在服务商给出摘要时返回
results[].contentstring网页正文;请求 need_content 且服务商支持时返回,未抓取到为空字符串
results[].datestring发布时间;格式随服务商不同
results[].scorenumber相关性打分;不同服务商可能省略
results[].site_namestring站点名称;不同服务商可能省略

响应字段说明 · 网页抓取

字段类型说明
titlestring页面标题
contentstringMarkdown 格式的网页正文
✓
抓取一次只处理一个 URL:搜索拿到多条 results[].url 后,按需逐条抓取即可。搜索与抓取的错误响应结构一致,都是 {"error": {"message", "type", "param", "code"}}。