跳转到主要内容
Venice 提供了独立的 API 分别用于发现网页和提取内容:
  • Web Search 返回包含标题、URL、摘要和日期的结构化结果。
  • Web Scrape 将选定的公开页面转换为 Markdown。
当你的应用在推理之前需要获取最新、可核查的源材料时,请将它们组合使用。

搜索网络

向 Search API 发送查询:
Brave 是默认的提供商,并提供零数据保留。Google 也可用,其查询会通过 Venice 匿名代理;Exa 也可用,并提供零数据保留。有关提供商选择及完整响应架构,请参阅 Web Search API 参考。

选择提供商

所有提供商接受相同的请求,每次搜索的价格也相同,因此切换提供商只需修改一个字段。区别在于返回的内容: 把结果传给模型时,更长的结果会变成输入 token,因此成本更高、处理时间更长。如果结果直接放入提示词,请限制包含的结果数量以及每条结果贡献的文本量。使用 google 时,请保留与查询匹配的段落,而不是每条结果的开头,开头往往是导航栏或 Cookie 横幅。 要了解各提供商在相关性、回答准确率、延迟和 token 成本方面的比较,请阅读网页搜索提供商基准测试。文中附有基准测试工具的链接,你可以用自己的问题重新运行对比。

抓取页面

选择结果后,将其公开 URL 发送到 Scrape API:
该端点以 Markdown 形式返回页面内容。它会优先请求站点原生的 Markdown 版本(若可用),否则使用基于浏览器的提取方式。

搜索到抓取的工作流

1

搜索

提交一个聚焦的查询并收集结构化结果。
2

选择来源

在获取页面内容之前,按相关性、域名和日期筛选结果。
3

抓取

仅从你的应用打算使用的页面中提取 Markdown。
4

使用或存储内容

将 Markdown 包含在提示中、创建嵌入、进行缓存,或保留源 URL 以供引用。
Web Search 和 Web Scrape 各自对每个账户设有每分钟请求数限制。超出限制的请求会返回 429;请使用指数退避进行重试,并将并行抓取保持在较小的并发池内。

独立搜索还是模型网页搜索?

当你的应用需要控制来源选择或希望复用检索到的内容时,请使用独立的 API。当你希望 Venice 在单次推理请求中处理检索时,请在模型请求中启用网页搜索。
Web Search 和 Web Scrape 是实验性 API。其请求和响应格式可能会在不另行通知的情况下发生变化。Web Scrape 仅接受可公开访问的页面,屏蔽自动化访问的站点可能会被拒绝。

相关资源

正在构建搜索到抓取的流水线?基于网页搜索的带引用回答 会一步步介绍完整工作流,包括来源选择、处理提取失败的页面,以及生成每条论断都能追溯到 URL 的回答。