OmniRoute 联网搜索完整指南/v1/search 端点与免费 DuckDuckGo 兜底策略【免费下载链接】OmniRouteNever stop coding. Free MIT AI gateway: one endpoint, 350 providers (90 free), 1200 models Kimi, Claude, GPT, Gemini, GLM, DeepSeek, MiniMax. Works with Claude Code, Codex, Cursor, OpenCode, Cline Copilot. Quota-aware auto-fallback, RTKCaveman compression saves 15-95% tokens, MCP/A2A, Desktop/PWA. Built by 450 contributors项目地址: https://gitcode.com/GitHub_Trending/om/OmniRouteOmniRoute 是一个免费 MIT 协议的 AI 网关其联网搜索功能让大模型一次 POST 到/v1/search端点即可完成网页搜索。即使你不配置任何付费搜索密钥它也会自动启用免费 DuckDuckGo 搜索兜底开箱即用零成本、零配置。 OmniRoute 联网搜索是什么OmniRoute 把“联网搜索”做成了 AI 网关的一等公民能力能力说明统一端点一个POST /v1/search接口背后可切换 20 余种搜索服务商免费兜底未配置任何密钥时自动降级到免费的 DuckDuckGo lite 搜索配额感知服务商被限流时自动 failover 到下一家不中断请求结果缓存相同查询 5 分钟 TTL 缓存重复搜索不产生额外费用成本记账每次搜索按服务商单价计入 API Key 预算免费源为 0核心实现分布在src/app/api/v1/search/route.ts端点入口与open-sse/config/searchRegistry.ts搜索服务商注册表约 530 行是所有搜索能力的单一事实来源。 /v1/search 端点怎么用端点提供两个方向1. 列出可用搜索服务商GETGET /v1/search返回当前所有可用的搜索服务商列表id、名称、支持的搜索类型会自动剔除被安全策略屏蔽的条目。适合客户端先发现再调用。2. 执行网页搜索POST请求体核心字段字段说明query搜索关键词必填provider可选。指定服务商如serper-search、duckduckgo-free不传则自动选择search_typeweb网页或news新闻max_results返回条数会被自动钳制到该服务商的上限如 DuckDuckGo 上限 25 条country/language地域与语言偏好filters域名包含/排除过滤include_domains/exclude_domainstime_range时间范围过滤content是否附带正文摘要响应为标准 JSON包含results标题、URL、摘要、相关度分、cached是否命中缓存与usage本次消耗查询数与美元成本缓存命中时为 0。 免费 DuckDuckGo 兜底策略为什么零配置也能搜这是 OmniRoute 联网搜索最有新手友好度的一处设计。注册表中 DuckDuckGo 服务商被标记为fallbackOnly: true见open-sse/config/searchRegistry.ts第 320 行附近的duckduckgo-free条目无需任何 API KeyauthType: none直接抓取 DuckDuckGo lite 页面的 HTML 结果月配额设为 999999实际不限仅受对端频率限制永远不会抢占付费源自动选择逻辑按单次查询成本从低到高排序但会跳过所有fallbackOnly服务商所以配置了 Serper$0.001/次等付费源时DuckDuckGo 不会被误选最后兜底才登场仅当没有任何服务商可用/被限流或主服务商执行失败时才把它提升为主选或备胎failover保证裸机部署的 OmniRoute 联网搜索永远有结果返回专属 HTML 解析路径它不走通用 JSON 适配器而是由open-sse/handlers/search.ts中专用的 HTML 解析分支处理这套last-resort 兜底策略在src/app/api/v1/search/route.ts的自动选择逻辑中有两段对应代码先遍历已配置服务商按成本择优再进入Last resort分支提升duckduckgo-free——无论是首次选主还是为失败准备备胎都会走到它。⚖️ 内置搜索服务商一览除 DuckDuckGo 外注册表内置的常用服务商部分服务商单次成本免费月配额支持类型Serper Search$0.0012500 次web / newsBrave Search$0.0051000 次web / newsJina Search$0.0021000 次webTavily Search$0.0081000 次web / newsExa Search$0.0071000 次web / newsSearXNG自建免费不限web / newsContext7文档免费不限webDuckDuckGo免费免费不限web在仪表盘的/dashboard/providers页面填入任意一家密钥即可启用对应服务商GET /api/search/providers会实时推导每家服务商的状态configured / missing / rate_limited。️ 搜索工具工作室可视化玩转 /v1/search不必手写 curl——OmniRoute 提供了Search Tools Studio路由/dashboard/search-tools三个标签页覆盖全部场景Search 标签查询 → 结果标题/URL/摘要/相关度支持选择重排Rerank模型用 LLM 重排结果Scrape 标签调用姊妹端点POST /v1/web/fetch抓取整页内容输出 Markdown / 文本 / HTML超 256 KB 自动截断提示Compare 标签同一查询并行打到最多 4 家服务商并排对比延迟、成本、结果数与 URL 重合度侧边配置面板可实时查看每家服务商的成本、配额与健康状态Export Code 还能一键导出 curl / Python / TypeScript 调用片段。完整设计文档见 docs/frameworks/SEARCH_TOOLS_STUDIO.md。❓ 常见问题FAQQ没配任何搜索密钥搜索会报错吗不会。自动选择链路最终会落到duckduckgo-free免费、无 Key这是刻意的零配置可用设计。Q为什么我配了 Serper却还是走 DuckDuckGo正常情况下不会。只有当 Serper 的所有凭据处于限流冷却中时才会降级可在 Search Tools 侧边栏或/api/search/providers查看实时状态。Q搜索有缓存吗有。相同查询 服务商 参数组合 5 分钟内命中缓存响应带cached: true且不计入成本usage.search_cost_usd为 0。Q能限制只用免费源吗可以。在设置中通过服务商屏蔽blockedProviders策略禁用付费源/v1/search的 GET 与 POST 都会自动尊重该策略。✅ 小结OmniRoute 的联网搜索把一个端点 多服务商 免费兜底做得非常彻底/v1/search屏蔽了 20 多家搜索服务商的差异成本感知的自动选择 限流 failover 保证可用性而免费 DuckDuckGo 兜底让任何新手克隆下来立刻就能搜到互联网。配合 Search Tools Studio 的可视化调试从零配置尝鲜到多服务商对比调优都是一条顺滑的路径。【免费下载链接】OmniRouteNever stop coding. Free MIT AI gateway: one endpoint, 350 providers (90 free), 1200 models Kimi, Claude, GPT, Gemini, GLM, DeepSeek, MiniMax. Works with Claude Code, Codex, Cursor, OpenCode, Cline Copilot. Quota-aware auto-fallback, RTKCaveman compression saves 15-95% tokens, MCP/A2A, Desktop/PWA. Built by 450 contributors项目地址: https://gitcode.com/GitHub_Trending/om/OmniRoute创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考