OmniRoute AI 网关
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md 安装 @user_1a99cb00/omniroute。
技能介绍
多供应商接入的真实痛点
把 290+ 提供商接到同一个 Agent 上,问题远不只是写几个 if-else:供应商的 429 限流和 5xx 故障没有统一语义,重试策略无法通用;同样一次 completion,不同厂商的价格可能差出一个数量级;而 Token 账单里有相当一部分是 prompt 冗余——长上下文编码任务中,重复的系统提示、文件内容往往可以在几乎不损失质量的前提下被压缩。
核心能力
OmniRoute 的思路是:在调用方和 provider 之间插入一层网关,对外只暴露一个统一端点,后面挂一整套路由抽象。
- 19 种路由策略:
priority、weighted、cost-optimized、headroom、cache-optimized等,外加零配置的auto/coding、auto/fast变体。路由决策可以基于价格、延迟余量或上下文类型,而不是写死的默认值。 - Token 压缩:RTK + Caveman 双层压缩,官方称平均节省约 89%,直接削减 prompt 中的冗余结构。
- 三层自愈:provider 级断路器(408/5xx 触发,60s/30s/15s 分档重置);连接冷却(指数退避 ×2,尊重
Retry-After);模型级锁定——只锁定出问题的模型,不牵连整条连接。 - 协议兼容:OpenAI ↔ Claude ↔ Gemini ↔ Responses API 走同一端点互转,配套 MCP server(104 工具)、A2A 协议、memory 与 guardrails。
适用边界
- 它是方法论加参考实现,不是托管服务:理解断路器和路由语义之后,仍需自行部署维护。
- 压缩策略要按任务类型评估质量损失,
auto/cheap不等于适合所有场景。 - 90+ 免费层有速率与配额限制,生产流量不宜默认依赖免费层。
使用场景
- 一个开发团队同时调用多个模型供应商,单个供应商宕机或限流时需要毫秒级切到备用模型,保持 Agent 服务不中断。
- 每月 API 账单来自十几个不同供应商,需要在保证质量的前提下把高成本请求自动路由到更便宜的兼容模型。
- 长上下文编码任务中 prompt 重复内容多,希望在几乎不损失质量的前提下把 Token 消耗降低一半以上。
- Agent 代码需要同时对接 OpenAI 和 Claude,不想为每个供应商维护一套调用逻辑,希望统一端点互转。
适合人员
- 自建 Agent 应用的全栈工程师,面临供应商频繁限流和宕机,需要一套自动回退机制保证线上服务稳定。
- 管理多个 AI 供应商账单的技术负责人,希望按成本、延迟余量动态路由请求,降低月度 Token 开支。
- 维护长上下文编码工具的开发者,苦于重复 prompt 推高 Token 账单,需要压缩方案在不损失质量的前提下降本。
- 同时对接多家模型 API 的平台工程师,不想为每个供应商维护独立调用层,需要一个统一端点完成协议互转。