OmniRoute 配额管理完全指南配额窗口、重置窗口与 Quota-Share 公平分摊 【免费下载链接】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 网关一个端点聚合 350 供应商、1200 模型Kimi、Claude、GPT、Gemini、GLM、DeepSeek 等并内置配额管理——配额窗口quota window追踪、重置窗口reset window感知与 Quota-Share 公平分摊让多个 API Key 共享同一账号时不再一家吃光、其余干等。本文带你从零理解并上手这三套机制。 配额窗口Quota Window每个供应商都有自己的时间刻度不同 AI 供应商的免费/订阅额度都挂在不同的时间窗口上。OmniRoute 为每个连接维护一套计划Plan由 planResolver.ts 自动解析内置目录中常见供应商的默认维度如下供应商默认配额维度单位 / 窗口 / 上限Codex百分比 /5h/ 100百分比 /weekly/ 100Kimi请求数 /hourly/ 1500阿里百炼百分比 / 5h / 100weekly / 100monthly / 100GLM / MiniMaxToken / 5hToken / weeklyAlibaba请求数 / monthly / 90000OpenAI / Anthropic无默认需手动配置一个池Pool可以配置多个维度每个维度独立判定如 Codex 同时看 5 小时和周两个窗口任一维度触顶都会拦截请求。窗口计数采用滑动窗口实现sqliteQuotaStore.ts 与 redisQuotaStore.ts核心思路是为每个 API Key 维护当前桶 上一桶两个计数器按经过的时间加权混合得到平滑的滚动消耗值精度约 99%避免了整点一刀切的抖动。 重置窗口Reset Window倒计时结束额度自动回血当供应商返回resetAt重置时间时OmniRoute 会持续跟踪倒计时展示仪表盘用formatResetCountdown(resetAt)之类的逻辑显示距重置还有 2h 35m自动恢复resetAt一过该账号自动重新参与路由——订阅优先路由中resetAt已过的配额读数会被立即刷新不受缓存 TTL 限制无需重启或手动操作过期读数归零重置窗口已过去的旧用量会直接按 0 计算不会显示永远快用完了的假数据。也就是说你不用盯着多久重置OmniRoute 会在窗口重置的第一时间把账号放回可用池。⚖️ Quota-Share 公平分摊多把 Key 共享一个账号怎么办这是配额管理最核心的一环。当多把 API Key 共用同一个上游账号比如 3 个 Codex 订阅时如果没有分摊逻辑Key A 的一次爆发就能把整窗额度耗尽Key B/C 只能干等重置。公平分摊算法fairShare.ts为每把 Key 计算fairShareAllowed 池上限 × (分配权重 / 100) remaining fairShareAllowed − 已消耗两种模式宽松 vs 严格条件模式行为全局已用 50%默认阈值宽松Generous允许借用其他 Key 的闲置份额池子尽量用满全局已用 ≥ 50%严格Strict严格 enforce 各自的公平份额阈值可通过环境变量QUOTA_SATURATION_THRESHOLD0~1调整。三种策略Policyhard超过份额 → 直接拦截429soft超过份额 → 只降权不拦截组合路由打分时乘 0.7 因子QUOTA_SOFT_DEPRIORITIZE_FACTOR让该 Key 更难被选中burst只要全局还有余量就放行适合弹性场景。另有capValue绝对上限无论何种模式触顶即拦截是最后的硬保险。️ 配置与查看控制台 环境变量控制台操作推荐新手进入/dashboard/costs/quota-share页面创建池、分配权重、查看每个维度的堆叠用量条、各 Key 的欠额/盈余与借用中标记以及烧录速率burn rate曲线进入/dashboard/costs/quota-share/plans选择供应商查看自动解析出的计划或手动覆盖维度写入provider_plans表。页面组件源码位于 src/app/(dashboard)/dashboard/costs/quota-share//dashboard/costs/quota-share/)。环境变量速查变量默认值说明QUOTA_STORE_DRIVERsqlite计数器存储sqlite或redisQUOTA_STORE_REDIS_URL—多实例部署时共享计数器QUOTA_SATURATION_THRESHOLD0.5达到该比例后切换严格模式QUOTA_SOFT_DEPRIORITIZE_FACTOR0.7soft 策略的降权系数QUOTA_CONSUMPTION_RETENTION_DAYS14计数桶保留天数数据存储怎么选SQLite默认零安装计数器存于本地数据库适合单机Redis可选多副本部署时共享计数器Lua 脚本保证原子自增配置失败会自动回退 SQLite 并告警。 容错设计配额引擎坏了不会挡住你的流量Fail-open拦截钩子在 chatCore.ts 中运行若配额引擎自身抛错请求会被放行并记录警告而不是全站 429漂移自校正响应后记录消耗是尽力而为若计数器偏差供应商返回的真实饱和度信号30 秒 TTL会在下次请求时校正全局估计在途租约被中止的请求占用的份额会自动老化释放不会被同连接的后续流量续命详见 11547-quota-share-inflight-lease.md。✅ 快速上手清单确认连接已添加打开 Quota-Share 页面创建第一个池用/plans页检查计划是否自动解析OpenAI/Anthropic 需手动配置给每把 Key 设权重敏感 Key 加capValue硬上限多副本部署时切换QUOTA_STORE_DRIVERredis观察 burn rate 曲线与重置倒计时验证窗口回血后账号自动回归路由。 延伸阅读QUOTA_SHARE.md、USAGE_QUOTA_GUIDE.md、OMNIROUTE_QUOTA_TELEMETRY.md掌握配额窗口、重置窗口与 Quota-Share 公平分摊这三件套你就能让 OmniRoute 上的多账号、多 Key 像一条永不枯竭的水流——用完自动回血分摊永不失衡。【免费下载链接】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），仅供参考