客户端 API 迁移

把 Bing v7 客户端迁到 Search1API

在支持的 Bing v7 客户端中修改 endpoint 和 subscription key，通过 Search1API 的 Bing 兼容 API 保留 webPages.value 结果格式。

Open WebUI — bash diff
-BING_SEARCH_V7_ENDPOINT="https://api.bing.microsoft.com/v7.0/search"
-BING_SEARCH_V7_SUBSCRIPTION_KEY="YOUR_BING_KEY"
+BING_SEARCH_V7_ENDPOINT="https://api.search1api.com/compat/bing/v7.0/search"
+BING_SEARCH_V7_SUBSCRIPTION_KEY="YOUR_SEARCH1API_KEY"

什么时候适合迁移

微软已于 2025 年 8 月 11 日停用 Bing Search API 并关闭原有实例。如果应用仍依赖 v7 结果格式，可以迁入 Search1API 基于 Bing 引擎提供的网页、新闻和图片搜索兼容端点。

原服务参考资料: Microsoft Bing Search API retirement notice

可以保留什么

支持的 Bing v7 查询参数和结果解析方式。
原有 Ocp-Apim-Subscription-Key 请求头，改为发送 Search1API key。
允许配置 endpoint 的 Open WebUI、LangChain Bing 客户端。

切换前需要确认

排序和可用元数据可能与旧 API 不同，不复现答案或额外的响应模块。
safeSearch、responseFilter、textDecorations 等选项会被忽略，依赖这些选项的应用需要先检查映射说明。
totalEstimatedMatches 表示返回结果窗口，不是全部匹配数的估计。新闻搜索必须传 q，不支持无查询词的头条请求。

迁移现有客户端

创建 Search1API key，在客户端中替换 Azure subscription key。
把可配置的 Bing endpoint 指向 /compat/bing/v7.0/search；新闻和图片使用各自的端点。
用实际查询验证 webPages.value 解析、过滤、分页和错误处理。

LangChain · BingSearchAPIWrapper — python
from langchain_community.utilities import BingSearchAPIWrapper
search = BingSearchAPIWrapper(
    bing_subscription_key="YOUR_SEARCH1API_KEY",
    bing_search_url="https://api.search1api.com/compat/bing/v7.0/search",
    k=5,
)
results = search.results("hono workers", 5)

示例与兼容技术文档保持一致。切换生产流量前，请用自己的查询验证过滤条件和结果处理。

客户端示例:Open WebUI / LangChain查看兼容技术文档

搜索使用 Search1API 积分，计入账户原有速率限制。读取页面全文或同时选择多个引擎可能增加费用，请查看各协议的计费说明。

查看定价

迁移常见问题

还需要 Azure 资源吗？

不需要。兼容端点使用 Search1API key、积分和速率限制，不使用原 Azure 资源，也不是恢复微软已停用的服务。

支持新闻和图片吗？

支持。兼容 API 分别提供 /v7.0/news/search 和 /v7.0/images/search 端点，技术文档中说明了字段和行为差异。

所有旧 Bing 客户端都能迁入吗？

客户端需要允许修改 endpoint 和 key。LangChain BingSearchAPIWrapper 和 Open WebUI 的请求格式已测试，写死微软域名的客户端需要配置支持或修改代码。