OmniRoute：聚合352个AI服务商免费额度的开源网关 | 前端进阶之旅

Full translation

完整中文译文

💰 每月约 1.47B 免费 Token

手动叠加各平台免费层非常痛苦——数十个 SDK、数十个速率限制，还搞不清自己实际有多少额度。OmniRoute 收录了 444 条免费层条目，涵盖 34 个循环池密钥，并从其中 16 个公布了正向月度预算的池加上 5 个按模型计的 Groq 上限（按共享池去重）中计算 Token 总数。经过地区身份验证（如今是 ModelScope）后才能解锁的配额单独展示，验证后约多出 6M Token，绝不计入总数。计算结果会持续显示在仪表板上（/dashboard/free-tiers）。

/dashboard/free-tiers 页面的动态摘要。完整方法论（池去重、积分层级、提供商条款）：docs/reference/FREE_TIERS.md。

这些数字每两周对照实时目录重新审计，会上下浮动——提供商终止免费层，数字就会下降；新提供商上线，数字就会上升。平台只发布目录实际计算的结果，绝不是向上取整的最佳情况。

⭐ 如果 OMNIROUTE 帮你省钱并让工作更轻松，请给仓库点个 Star。

⭐ 如果 OMNIROUTE 帮你省钱并让工作更轻松，请给仓库点个 Star。

💬 加入社区

👋 关注维护者——第一时间获取新提供商、版本更新和使用技巧：

问题、提供商技巧、路线图与支持 → Discord · Telegram · WhatsApp 🌍 全球 / 🇧🇷 巴西 / Portal

📈 Gateway 持续壮大

→ 路线图——驶向 v3.9.0 LTS

🆓 安装即可使用——无需密钥、无需配置

# 全新安装、零凭证——`auto` 已经可用：
curl http://localhost:20128/v1/chat/completions \
  -H "Content-Type: application/json" \
  -d '{"model":"auto","messages":[{"role":"user","content":"Hello!"}]}'

想用特定的免费后端？直接调用 oc/…（OpenCode Free）。然后升级到 auto，让 OmniRoute 来选。

📦 Python、Node.js、PHP 和 cURL 的复制粘贴快速上手脚本 → examples/quickstart/

🤝 由我们的开源伙伴支持

想作为开源伙伴加入吗？这些公司支持开源并帮助 OmniRoute 持续发展 — 我们公开说明他们给我们的每一 Token 都用在了哪里。联系方式：diegosouza.pw@outlook.com

带有 aff=omniroute 标签的链接是合作伙伴链接。它们在为项目提供资金支持，对你没有额外成本。

本部分仅用于推荐/优惠券代码。赞助合作在上面的 🤝 由我们的开源伙伴支持部分。OmniRoute 与此处列出的提供商没有任何赞助或合作关系 — 这些是任何人都可以使用的公开优惠券。

发现有其他提供慷慨免费注册优惠券以惠及 OmniRoute 用户的提供商？请提交 issue，我们会将其添加到此列表。

🎯 Combos — 旗舰功能

Combo 是 OmniRoute 自动路由的模型链。当配额用完、某个提供商故障或成本飙升时，Combo 可以切换到下一个符合条件的健康模型。🛡️

⚡ 零配置 — 只需使用 auto

无需创建 Combo。只需将模型设置为 auto（或其变体），OmniRoute 就会根据你已连接的提供商构建一个虚拟 Combo，并实时评分：

🔀 或者自行构建 — 19 种路由策略

全部 19 种策略 — 每个 Combo 步骤可自由混合搭配：

Auto-Combo 引擎根据 16 个因素对每个候选模型评分（健康状态、配额、成本、延迟、任务匹配度、质量、会话可用性……）— 详见 docs/routing/AUTO-COMBO.md。

🧱 内置容错（三层独立防护）

📖 Auto-Combo 引擎 · 容错指南

🏆 OmniRoute 的独特之处

📊 完整方法论及与 9router、OpenRouter、CLIProxyAPI 和 LiteLLM 的逐项对比 → docs/comparison/OMNIROUTE_VS_ALTERNATIVES.md

OmniRoute 采用 MIT 许可并在开源环境下维护。如果它为你节省了时间或金钱，以下是保持其独立性的方式 — 选择适合你的方式。赞助永远不会影响路由优先级；赞助买的是曝光度，不是排名。

🇧🇷 PIX — 即时到账，无手续费（巴西）

密钥（随机）：5d865059-bc44-483a-962d-43ceb80126eb

00020101021126580014br.gov.bcb.pix01365d865059-bc44-483a-962d-43ceb80126eb5204000053039865802BR5922OMNIROUTE CONTRIBUICAO6006BRASIL62070503***630475DD

⚠️ 只在显示的网络上发送每笔币 — 在错误网络上发送可能会丢失资金。

🐛 发现 bug 或有反馈？请开启 Discussion。

开发者说明：项目在 npm install/postinstall 期间可能会生成一个本地 .env 文件以方便开发者。该文件通过 .gitignore 故意忽略（参见 .gitignore），严禁提交 — 如果意外提交，请轮换任何暴露的密钥并从历史记录中删除该文件。参见 docs/DEVELOPER-ENVIRONMENT.md 获取管理本地环境文件和密钥的指导。

主要免费层级标题仍为约 1.47B Token/月，来自上述已去重池化的记录目录。临时提供商注册积分可单独将首月提升至约 2.10B。Radar 是一个可选的签名目录覆盖层，面向希望在 OmniRoute 版本发布间隙获取更新免费模型可用性的人群；社区目录和所有现有免费功能保持免费。

支持者可获取实时目录和其他提供商机会。其独立的可变上限约为 3B Token/月，具体取决于提供商可用性。该上限不是保证：提供商可随时更改配额、资格、模型或地区。

Radar 是可选的且仅限 GET。OmniRoute 客户端不会上传提示词、流量、提供商配置、使用遥测或本地公告关闭状态。在 radar.omniroute.online/planos 了解资格和当前目录。

v3.8.20 → v3.8.50 最新亮点。完整历史记录见 CHANGELOG.md。

🎛️ OmniConductor — 入站 A2A 委托到你的智能体集群、Conductor 技能在 Agent Card 上，以及带 Faro 即按即说语音聊天的仪表盘面板。→ A2A Server

🛂 自适应准入与过载保护 — 重量级聊天请求排队而非返回 503，每个连接按原子性 RPM 滚动租约。→ 弹性指南

🗂️ 规范化的 /v1/models 排序 — 每个提供商一个连续的分组块（Combo 置顶），在所有目录源中保持稳定。→ API 参考

🗜️ 压缩加固 — 默认开启的膨胀防护、Caveman 压缩包适用于 DE/FR/JA + 中文（文言文）、RTK 过滤器适用于 Gradle 和 .NET。→ 压缩

💸 诚实的平板费率成本 — 订阅 / coding-plan 提供商在成本分析中读数为 $0；预算、配额和路由继续估算。→ API 参考

⚖️ 配额分配路由 — 在池化密钥间公平分配共享账户的配额，保持工作节约以便空闲切片可以借出。→ 弹性指南

🤖 一键式 CLI/智能体设置 — 13 个注册的 setup-* 命令；omniroute run 可启动 7 个 CLI（Claude Code、Codex、Aider、Goose、OpenCode、Qwen Code、Gemini CLI）；omniroute configure 支持 10 个目标，带有交互式提供商+模型选择器和按上下文收藏。→ CLI 集成

🛰️ 远程模式 — 使用作用域令牌（connect / contexts / tokens）驱动远程 OmniRoute，外加一个适用于 VPS 安装的反重力 OAuth 辅助工具。→ 远程模式

🧭 更智能的自动路由 — auto/<category>:<tier> Combo、融合（模型面板 + 评判）、任务感知路由、每请求模型/模式/美元预算覆盖。→ Auto-Combo

🗜️ 可插拔压缩 — 12 种可组合引擎 + 压缩工作室：LLMLingua-2、双层 Ultra、omniglyph、每步保真度门控、GCF v3.2、拖拽重排序编辑器。→ 压缩

🕵️ 透明 MITM 解密（TPROXY）— 捕获忽略代理环境变量的 CLI，每个 SNI 独立 CA + 信任存储安装器。→ MITM/TPROXY

💸 成本遥测无处不在 — 每个端点上的 X-OmniRoute-* 成本/用量头、缓存命中节省头、每密钥美元消费配额。→ API 参考

🧠 由你控制的记忆 — 默认关闭，可选开启 int8 向量量化 + 类型化衰减，每请求 x-omniroute-no-memory。→ 记忆

🛡️ 安全——在每个 LLM 路由上启用 prompt 注入防护（红队测试套件），可选的凭证掩码护栏（双向泄露 API 密钥/密钥），免费 DuckDuckGo 作为备选网络搜索，以及仪表板的可选 OIDC 登录网关（密码登录始终可用）。

🖼️ 新增端点——/v1/ocr（Mistral OCR）和 /v1/audio/translations（Whisper 风格）完善了媒体接口覆盖。

🎨 图像/视频/音频生成——统一媒体 API：xAI Grok Imagine、Novita AI video、ComfyUI、Magnific、Adobe Firefly、Segmind，以及 ElevenLabs 等语音提供商。

🌍 部署与运维——反向代理 basePath、浏览器语言自动检测、每密钥设备追踪、根级 MITM 信任、zh-TW 本地化。

🤝 更多提供商与智能体——云端智能体（Codex Cloud、Cursor、Devin、Jules）、Grok Build（xAI，含浏览器 + OAuth 登录）、Ollama 优先卡、Claude Opus 5 和 Sonnet 5、Kimi 官方合作（Code/Web/Moonshot）、Zed、Requesty、SenseNova、Yuanbao、Agnes AI……以及更新的 352 提供商目录。

📡 路由透明性——每个响应都携带 X-OmniRoute-Decision 头，命名策略/提供商/延迟信息；新的缓存优化组合策略 + Auto-Combo cacheAffinity 因子将重复请求路由回持有缓存前缀的连接；只读 /v1/auto-combo/{channel}/candidates 端点暴露 auto/* 频道的实时候选池。

⚡ 本地性能与基础设施——一键本地 Redis、Cloudflare Workers / Deno Deploy relay 部署器、Bifrost & Mux 作为托管嵌入式服务。

🧩 附赠功能——插件框架与市场、Omni/Agent/GitHub 技能框架、Obsidian vault 集成（22 个 MCP 工具）、OpenAI 兼容 Batch & Files API、语义响应缓存、排行榜游戏化、ACP 智能体发现（15 个内置智能体）、定时日志导出到 BigQuery、自动/混沌故障注入、Telegram 机器人桥接、应用内版本管理器和 LMArena-ELO 免费提供商排名。

🤖 兼容的 CLI 与编码智能体

一个配置——http://localhost:20128/v1——每个 AI IDE 或 CLI 都运行在免费或低成本模型上。

📖 全部 36 个工具的逐工具设置（26 个 CLI Code + 10 个 CLI Agents）→ docs/reference/CLI-TOOLS.md · 🧩 OpenCode 插件 → @omniroute/opencode-provider

通过 OmniRoute 用一条命令启动任何支持的 CLI——无需写配置文件，凭据按进程注入，Qwen/Gemini 获得一个一次性隔离目录：

omniroute run claude   --model openai/gpt-5.4          # Claude Code
omniroute run codex    --model glm/glm-5.2             # OpenAI Codex CLI
omniroute run aider    --model glm/glm-5.2 -- --message "reply OK"
omniroute run goose    --model glm/glm-5.2
omniroute run opencode --model glm/glm-5.2 -- run "reply OK"
omniroute run qwen     --model glm/glm-5.2 -- -p "reply OK"
omniroute run gemini   --model glm/glm-5.2 -- --skip-trust -p "reply OK"

# 或者交互式选择 provider+model，并写入工具自身的配置：
omniroute configure codex          # 同时支持：claude opencode qwen aider goose gemini cline continue kilo

每条命令都遵循活动远程上下文（omniroute connect <host>），--dry-run 预览确切 env/参数而不执行，--api-key-env NAME 将密钥保留在 shell 历史记录之外。

🌐 352 个 AI 提供商——152 个标记为免费

352 个注册提供商，覆盖标准聊天、媒体、搜索、本地、云端智能体和系统集合，其中 152 个携带 hasFree: true 发现元数据。聊天模型注册表覆盖 229 个提供商 / 2,554 个不同提供商-模型对 / 1,283 个原始模型 ID；独立的免费预算目录有 444 个按模型行、34 个循环池和 52 个循环/无密钥永久免费提供商。这些是不同的计量口径，设计如此；定义和池去重计算位于提供商参考和免费层级。

🏢 每个主要实验室——通过一个端点

……以及 330 多个——每个图标都从仪表板的提供商目录实时解析。📖 提供商参考

🆓 永久免费——$0，无需信用卡

📖 完整机器可读目录 → docs/reference/PROVIDER_REFERENCE.md

🖥️ OmniRoute 运行在哪里——任意位置

同一个应用，你的机器，你的规则。从全局 npm 安装到手机上的 Termux。

📖 Docker 指南 · 桌面版 · 菜单栏托盘 · Termux · PWA · OpenCode

🧩 新增：OmniRoute 内置于 VS Code 原生 Copilot Chat

无需新侧边栏，无需新聊天界面——OmniRoute 提供的每个模型都出现在你已经在用的 Copilot Chat 模型选择器中。自 VS Code 1.122 起，提供商模型无需 GitHub 登录或 Copilot 订阅即可工作——智能体模式、工具调用和视觉，免费。

安装 OmniCopilot 扩展，指向 OmniRoute 服务器（默认为 localhost:20128），然后打开 Copilot Chat → 模型选择器 → 管理模型… → OmniRoute。

从编辑器内：打开扩展视图，搜索"OmniRoute"，点击安装——在两个商店上工作方式相同。源代码、问题和发布手册位于 diegosouzapw/OmniCopilot。

📖 VS Code Copilot Chat 指南——设置、选择器显示内容、标签页中的仪表板、故障排除

🎩 新增：OmniRouteTray——你的网关，生活在菜单栏中

omniroute serve 在始终开启时表现最佳。OmniRouteTray 将其转变为 macOS 菜单栏应用：启动服务器、保持重启后继续运行、就地更新、实时令牌预算触手可及——无需打开终端窗口，无需 npm install -g omniroute 来管理。

使用 Tauri v2（Rust 核心体积小到可以忽略不计）构建，附带自己签名的 Node 24 运行时并管理应用自有的 OmniRoute 安装，因此永远不会与全局 node/bun 冲突。它共享你现有的 ~/.omniroute/ 配置和数据库——所以它就是你已经运行的同一个 OmniRoute，只是戴了一顶帽子。🎩

brew install --cask zoispag/tap/omniroute-tray

更倾向下载？从 Releases 获取最新 .dmg。源代码、问题和构建文档位于 zoispag/omniroute-tray。💛 @zoispag 的社区项目——非官方 OmniRoute 版本。

🔒 隐私与本地优先