SuperAPI AI 工具集

omniroute-cli-providers

部署与运维

查看项目

更新于 10-22 16:16

技能介绍

OmniRoute CLI Providers 提供一组命令行能力,用于在终端中管理 OmniRoute 的模型服务商连接、OmniRoute API 密钥、模型列表、OAuth 流程、多账号节点、路由组合以及配额与用量信息。使用前需要安装 omniroute CLI,安装与全局参数见 CLI 入口技能。该技能本身未提供安装命令。

服务商目录方面,可用 omniroute providers available 查看完整服务商目录,并支持 --search 按 id、名称或别名筛选、--category 按类别筛选、--json 输出机器可读结果。类别包括 api-key、oauth、free、local、combo。已配置的连接可用 omniroute providers list 列出,并支持 --json。

连接测试方面,omniroute providers test 测试单个已配置连接,omniroute providers test-all 测试所有活跃连接并以 TUI 展示实时通过或失败,加 --json 可得到机器可读结果。omniroute providers validate 仅做本地结构校验,不发起 HTTP 请求。

API 密钥管理针对 API Manager 下签发的 OmniRoute API 密钥,而非服务商凭据,支持 list、add、remove、regenerate、revoke、reveal、usage、rotate 以及查看密钥过期时间。密钥策略可 show 与 set,设置限流数值、限流窗口与权限,例如 chat、models。

模型方面,omniroute models 列出所有服务商模型,支持按服务商筛选、按名称搜索与 JSON 输出。OAuth 服务商支持 list、login、logout、status、refresh;对 Gemini、Windsurf、Antigravity 等 OAuth 服务商,login 会在浏览器中打开 OmniRoute 仪表盘的 OAuth 流程。

多账号路由方面,provider nodes 允许为一个逻辑服务商挂载多个 API 密钥或账号,以进行轮询或故障转移,支持 list、add、remove、test。路由组合支持 list、create、switch、delete 与 suggest;create 可指定策略与目标列表,策略可选 priority、weighted、round-robin、fill-first、least-used、cost-optimized、auto、random、strict-random、p2c、reset-aware、lkgp、context-optimized、context-relay 等。组合的完整 REST API 见 omniroute-routing 技能。

配额与用量方面,omniroute quota 查看服务商配额用量与重置时间,omniroute usage 查看请求与 token 用量汇总,omniroute cost 查看按服务商或模型的成本明细。压缩方面可查看状态、设置 rtk、stacked 或 off 模式,并用 preview 预览示例文本的节省效果。健康检查 omniroute health 提供熔断器、缓存与内存等详细信息。

常见错误方面,providers test 返回 401 通常表示该服务商存储的 API 密钥错误,可用 keys remove 与 keys add 重置;OAuth login 打开后无法完成可能是 OAuth 令牌端点被防火墙阻挡,可改用 API 密钥认证;combo create 报 strategy unknown 时需使用上述列出的策略之一。