Core control
让请求不中断
当某个目标不可用或配额耗尽时,OmniRoute 会选择下一个健康的目标。
通过一个 OpenAI 兼容端点在 352 家提供商之间路由,并自动故障转移。
OmniRoute × Cheaper Inference
把 OmniRoute 的自动故障转移和开发者工具,与 Cheaper Inference 按成本排序的市场结合起来。每个符合条件的请求都从最便宜的可用提供商路由开始。
| 模型 | 输入价格 | 输出价格 | 节省 | 上下文 | 详情 |
|---|---|---|---|---|---|
| gpt-5.6-lunaOpenAI · text | 省 60% | 1.1M | |||
| gpt-5.6-terraOpenAI · text | 省 60% | 1.1M | |||
| gpt-oss-120bOpenAI · text | 省 59.52% | 128K | |||
| deepseek-v4.1-flashDeepSeek · text | 省 50% | 1.0M | |||
| gpt-5.6-solOpenAI · text | 省 50% | 1.1M | |||
| glm-4.5Z.ai · text | 省 45% | 128K | |||
| glm-4.6Z.ai · text | 省 45% | 198K | |||
| glm-4.7Z.ai · text | 省 45% | 128K |
核心控制
Core control
当某个目标不可用或配额耗尽时,OmniRoute 会选择下一个健康的目标。
Core control
12 引擎流水线可将符合条件的上下文减少 15–95%。文档中的工具密集型示例减少了 ~89%。
Core control
90+ 个免费额度,以及 56 家周期性或免密钥的永久免费提供商。免密钥快速上手无需信用卡。
Core control
通过一个端点配置 Claude Code、Codex、Cursor、Cline、Copilot、Antigravity 及其他受支持的客户端。
Core control
在 /v1 接收 OpenAI、Claude、Gemini 和 Responses API 请求。
Core control
熔断器、加密凭据、MCP、A2A、记忆、护栏和评估随自托管网关一并提供。
提供商目录
目录涵盖聊天、媒体、搜索、本地运行时、云端代理和系统集成。
352 家提供商+
全部藏在一个本地端点之后。
所有客户端指向的同一个端点http://localhost:20128/v1
快速上手
安装软件包,启动网关,然后把任意 OpenAI 兼容客户端指向端口 20128。
全局安装 omniroute npm 包。
$ npm install -g omnirouteadded 1 package
在端口 20128 同时启动 API 和控制台。
$ omniroute▸ dashboard ✓ http://localhost:20128/dashboard▸ api ...... ✓ serving on :20128
使用 http://localhost:20128/v1;全新安装即可使用免密钥的 auto 路由。
$ curl localhost:20128/v1/models✓ models listed
网关控制
在本地控制台配置故障转移、配额、压缩、记忆、MCP 和 A2A。
Gateway control
把模型设为 auto,或用 19 种策略和分层故障转移构建自己的组合。
使用现成模式,或围绕你关心的目标组合 19 种策略。
Gateway control
持久化对话记忆,支持 FTS5 关键词和 Qdrant 向量召回。
Gateway control
提供商熔断、连接冷却和模型锁定,在最小有效范围内隔离故障。
Gateway control
跨 90+ 个免费额度的池去重计量。
公开的免费额度容量,去重后统计。
Gateway control
12 个可组合引擎,处理工具输出、上下文和响应风格。
将符合条件的 token 减少 15–95%。
Gateway control
内置服务器,在 33 个作用域中暴露 110 个网关工具。
110 个工具 · 33 个作用域 · stdio / HTTP
Gateway control
具备 6 项技能的 JSON-RPC 代理服务器。
6 项技能 · JSON-RPC 2.0 · Agent Card
Gateway control
重复请求可直接从缓存返回,响应头会报告由此节省的开销。
X-OmniRoute-Cache: HIT
客户端兼容性
把 OpenAI 兼容的 CLI 或编辑器指向一个本地 base URL;背后的提供商由 OmniRoute 处理。
http://localhost:20128/v1
curl http://localhost:20128/v1/chat/completions \
-H "Authorization: Bearer $OMNIROUTE_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"auto","messages":[{"role":"user","content":"Hello"}]}'OmniCopilot
OmniCopilot 把 OmniRoute 模型加入现有的模型选择器。
支持 VS Code 稳定版和 Insiders。可从 Marketplace 或扩展视图安装。
适用于 Cursor、Windsurf、VSCodium、Theia、code-server、Gitpod 及其他兼容编辑器。
提供商模型可通过 OmniRoute 在 Copilot Chat 中运行,推理无需经过 Copilot 订阅。
常见故障模式
看看每种常见故障模式对应哪项控制。
文档快照
各项能力已于 2026-08-30 对照所链接的项目文档核查。
| 能力 | OmniRoute (在新标签页中打开) | 9Router (在新标签页中打开) | LiteLLM (在新标签页中打开) | CLIProxyAPI (在新标签页中打开) |
|---|---|---|---|---|
| 提供商 | 352 | 40+ | 100+ | 8+ upstreams |
| 路由策略 | 19 | 3-tier | retry / priority | round-robin / fill-first |
| 带 UI 的分层故障转移 | Yes | Yes | Manual policy | Multi-account |
| Token 压缩 | 12 engines · 15–95% | RTK / Headroom / Caveman | No built-in pipeline | HTTP compression |
| 能力 | OmniRoute (在新标签页中打开) | 9Router (在新标签页中打开) | LiteLLM (在新标签页中打开) | CLIProxyAPI (在新标签页中打开) |
|---|---|---|---|---|
| 内置 MCP 服务器 | 110 gateway tools | No | MCP client / gateway | No |
| A2A 协议 | Server · 6 skills | No | A2A client / gateway | No |
| 云端代理 | Codex / Cursor / Devin / Jules | No | No | Sidecar integrations |
| 能力 | OmniRoute (在新标签页中打开) | 9Router (在新标签页中打开) | LiteLLM (在新标签页中打开) | CLIProxyAPI (在新标签页中打开) |
|---|---|---|---|---|
| 故障隔离层 | 3: provider / connection / model | Cooldown | Cooldown / retry | Cooldown |
| 持久化记忆 | FTS5 + vector | No | Semantic cache | No |
| 护栏 | PII / injection / vision | No | Yes | Cloaking controls |
| 评估框架 | Built in | No | No | No |
| TLS 指纹控制 | wreq-js | No | No | uTLS |
| 能力 | OmniRoute (在新标签页中打开) | 9Router (在新标签页中打开) | LiteLLM (在新标签页中打开) | CLIProxyAPI (在新标签页中打开) |
|---|---|---|---|---|
| 控制台技术栈 | Next.js 16 | Next.js 16 | Next.js | Next.js / React |
| UI 语言 | 38 | 10 | Not documented | 3 |
| OAuth 提供商 | 25 | 6 | SSO | CLI auth |
| 可自托管 | Yes | Yes | Yes | Yes |
| 许可证 | MIT | MIT | MIT + enterprise | MIT |
基于公开 README 和官方文档快照;在采购或部署决策前请核实所链接的来源。
部署
安装到笔记本、服务器或手机上,或通过受支持的编辑器和插件连接。
在任意受支持的桌面系统上一条命令搞定
npm install -g omniroute打开指南 (在新标签页中打开)AMD64 和 ARM64 多架构镜像
docker run … diegosouzapw/omniroute打开指南 (在新标签页中打开)Windows、macOS 和 Linux 上的原生窗口与系统托盘
npm run electron:build打开指南 (在新标签页中打开)Raspberry Pi、ARM 服务器和 Apple Silicon
native arm64无需 root 即可在 Android 上运行
pkg install nodejs && npx -y omniroute打开指南 (在新标签页中打开)全屏、支持离线、可从浏览器安装
Add to Home Screen打开指南 (在新标签页中打开)原生 OpenCode 提供商插件
@omniroute/opencode-provider打开指南 (在新标签页中打开)Copilot Chat 选择器中的 OmniRoute 模型
Install OmniCopilot打开指南 (在新标签页中打开)自行修改并参与贡献
npm install && npm run dev打开指南 (在新标签页中打开)路由
使用现成模式,或围绕你关心的目标组合 19 种策略。
autoBalanced defaultcurl http://localhost:20128/v1/chat/completions \
-H "Content-Type: application/json" \
-d '{"model":"auto","messages":[{"role":"user","content":"Write a TypeScript retry helper."}]}'Routing alias auto selected. Objective: Balanced default. Fallback enabled.
先用完已有配额,再动用付费 API。
priority · fill-first在密钥和账户之间均衡流量,降低速率限制压力。
weighted · round-robin · p2c · least-used · headroom路由到成本最低的合格目标。
cost-optimized把长上下文留给容得下的模型,必要时再中继。
context-relay · context-optimized · cache-optimized把合格流量分散到各个目标。
random · strict-random使用 15 因子评分、最近可用记录和感知重置的时间窗口。
reset-window · reset-aware · lkgp · auto · fusion · pipeline免费额度计量
455 条目录条目去重为 40 个周期性额度池;只有公开的正向预算计入头条数字。
上下文压缩
工具输出、重复上下文和臃肿的结构化数据可以在到达模型之前被压缩。
上下文在符合条件的 token 上减少 15–95%token
压缩前: The function should iterate over the list of items, and for each item, it should check whether the value is greater than zero, and if so, add it to the running total. 压缩后: sum all list items where value > 0
同样的指令。更少需要付费的上下文。
The function should iterate over the list of items, and for each item, it should check whether the value is greater than zero, and if so, add it to the running total.sum all list items where value > 0x-omniroute-compression: standard已选择 Standard 压缩。公开范围 ~30%。
控制优先级:请求头 → 组合 → 配置 → 自适应策略 → 默认值。
故障隔离
一个坏密钥不该拖垮提供商。一个受限模型不该拖垮连接。
网络控制
代理作用域控制网络路由,本地优先存储把运行数据留在你的机器上。
全局、按提供商或按单个连接路由。
匹配受支持的提供商客户端,直至选定的传输层特征。
密钥、用量和历史留在你掌控的主机上。
本地控制台
在 localhost:20128/dashboard 管理提供商、组合、分析、健康状况和成本。
代理协议
OmniRoute 可将其网关暴露给 MCP 客户端、A2A 网络和受支持的云端编码代理。
33 个作用域中的 110 个工具,支持 stdio 和 HTTP 传输。
110 个工具 · 33 个作用域 · stdio / HTTP
claude mcp add omniroute --type http --url http://localhost:20128/api/mcp/stream6 项技能,覆盖智能路由、配额、发现、成本分析和健康报告,基于 JSON-RPC 2.0。
6 项技能 · JSON-RPC 2.0 · Agent Card
通过一个编排界面连接受支持的 Codex、Cursor、Devin 和 Jules 工作流。
Codex · Cursor · Devin · Jules
附加服务
以托管 sidecar 方式运行 Bifrost、9Router 或 CLIProxy,或运行完整的集群配置。
把 Notion 和 Obsidian 接入为基于 MCP 的上下文来源。
提示注入检查、可选的 PII 脱敏和标准化安全过滤,不绑定任何提供商。
在运维分析之外,跟踪连续记录、成就和实时节省。
来自社区
看看开发者在 X、Reddit 和 YouTube 上构建、提问和分享的内容。
来自 32 个频道的 32 个视频查看全部 32 个社区视频
I've been experimenting with Kiro Pro, and I found a setup that gives me the Claude Code CLI experience while using my Kiro subscription.
Been 3 days with omniroute and it is amazing.
25 posts from X · 25 Reddit posts查看所有帖子
公开构建
查看来自已提交 GitHub 快照的 star、fork、贡献者和发布。
2026-10-16 的快照
聊天、支持与路线图
(在新标签页中打开)新闻与公告
(在新标签页中打开)全球社区
(在新标签页中打开)Comunidade Brasil
(在新标签页中打开)OmniRoute by Cheaper Inference
自托管 OmniRoute,或从 Cheaper Inference 开始,使用按成本排序的托管网关。