模型联网接口
用同一把胜算云 Key 调用模型的联网能力:联网搜索(Bocha / DeepSeek / Tavily 三家共用 POST /v1/tools/search,用 model 选择)与网页抓取(deepseek/fetch 把网页正文转成 Markdown)。响应结构统一,可在 Agent 里「先搜索、再抓取正文」串联使用。
端点列表
三家联网搜索怎么选
三个服务共用 POST /v1/tools/search 与同一套响应结构,只靠 model 区分,切换服务商不需要改代码结构。
| 服务 | model | 条数参数 | 专有参数 |
|---|---|---|---|
| Bocha | bocha/bocha-web-search | count(1~50) | summary 额外摘要、freshness 时间筛选、include / exclude 站点限定与排除 |
| DeepSeek | deepseek/search | count(1~50) | ori_question 原始问题、localization、need_content 返回正文 |
| Tavily | tavily/tavily-search | max_results(0~20) | search_depth 搜索深度、topic / days / language 筛选、include_domains / exclude_domains、need_content |
三家的关键词参数都叫 query,但条数参数不同:Tavily 用 max_results,另外两家用 count;三家都有 need_content 这一项(字段名一致,返回正文的能力以服务商实际支持为准)。
响应字段说明 · 联网搜索
| 字段 | 类型 | 说明 |
|---|---|---|
results | array | 结果列表;无结果时为 [] |
results[].title | string | 网页标题 |
results[].url | string | 网页链接,可直接交给 POST /v1/tools/fetch 抓取正文 |
results[].snippet | string | 网页摘要片段;不同服务商可能省略 |
results[].summary | string | 额外生成的摘要;仅在服务商给出摘要时返回 |
results[].content | string | 网页正文;请求 need_content 且服务商支持时返回,未抓取到为空字符串 |
results[].date | string | 发布时间;格式随服务商不同 |
results[].score | number | 相关性打分;不同服务商可能省略 |
results[].site_name | string | 站点名称;不同服务商可能省略 |
响应字段说明 · 网页抓取
| 字段 | 类型 | 说明 |
|---|---|---|
title | string | 页面标题 |
content | string | Markdown 格式的网页正文 |
抓取一次只处理一个 URL:搜索拿到多条
results[].url 后,按需逐条抓取即可。搜索与抓取的错误响应结构一致,都是 {"error": {"message", "type", "param", "code"}}。