用途:在命令行中管理 OmniRoute 的供应商连接与 API 密钥,覆盖供应商目录查询、连接配置、连通性测试、密钥轮换、OAuth 登录、多账号节点、路由组合、配额用量与压缩模式等运维操作。
安装:npm install -g omniroute(或使用 npx omniroute),然后用 omniroute --version 确认版本。
主要能力:
- 供应商管理:providers available 查看目录(支持 --search 与 --category 过滤,类别包括 api-key、oauth、free、local、combo);providers list 列出已配置连接;providers test 和 test-all 测试连接(test-all 提供交互式进度,加 --json 输出机器可读结果);providers validate 只做本地结构校验;providers rotate 轮换密钥(支持 --new-key、--from-env、--oauth、--dry-run 等);providers status 和 metrics、metric 查看状态与指标。
- 密钥管理:keys list/add/remove/regenerate/revoke/reveal/usage/rotate 管理 OmniRoute API 密钥;keys policy show/set 设置限流窗口与权限;keys expiration list 查看过期时间。
- 模型与 OAuth:models 支持按供应商过滤、按名称搜索和 JSON 输出;oauth list/login/logout/status/refresh 管理 OAuth 供应商,login 会在浏览器打开 OmniRoute 仪表盘的 OAuth 流程。
- 多账号与路由:nodes list/add/remove/test 为同一逻辑供应商挂载多个密钥或账号,实现轮询或故障转移;combo list/create/switch/delete/suggest 管理路由组合。
- 用量与运维:quota、usage、cost 查看配额、请求与 token 用量、成本明细;compression status/set/preview 管理 RTK、stacked 等压缩模式;health 查看熔断器、缓存与内存健康状态。
使用方式:安装后按子命令调用,例如 omniroute providers available、omniroute providers test-all --json、omniroute keys rotate <id>、omniroute combo create <name> --strategy priority --targets anthropic/claude-opus-4-7,openai/gpt-4o。多数命令支持 --json 便于脚本集成。
适用场景:需要批量检查与轮换供应商密钥、管理多账号容灾、在终端切换路由组合、核对配额与成本、或排查连接失败等运维场景。
限制与注意:资料未说明授权方式、平台范围、收费信息与速率限制,暂未提供;test 返回 401 通常表示该供应商存储的密钥错误,可先用 keys remove 再 keys add 重置;OAuth 登录卡住可能是令牌端点被防火墙拦截,可改用 API 密钥认证;combo create 的策略需使用内置取值(priority、weighted、round-robin、fill-first、least-used、cost-optimized、auto、random、strict-random、p2c、reset-aware、lkgp、context-optimized、context-relay)。commands 中的 keys 管理的是 OmniRoute 发放的 API 密钥,而不是供应商凭证。