mcpField
O
omni-providers

omni-providers

github.com/cheaper-inference云与 DevOps82.3k1.2k 次安装今天更新
代码仓库

关于 omni-providers

omni-providers 是通过 OmniRoute REST API 管理 AI 提供商连接的技能。它支持连接生命周期操作、认证流程、测试、模型管理，以及健康状态和用量查看。

主要功能

  1. 01列出、新增、更新和移除连接
  2. 02管理 API 密钥与 OAuth 流程
  3. 03测试单个或批量连接
  4. 04导入并刷新凭据
  5. 05查看模型、指标与健康状态

适用场景

  1. 01新增或移除提供商连接
  2. 02令牌过期后续期凭据
  3. 03路由前测试提供商
  4. 04查看提供商健康状态与用量

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/cheaper-inference/omniroute --skill omni-providers

安装后在 Claude Code 中输入/omni-providers确认已加载。

附带文件references/endpoints.md

详细介绍

概述

通过 REST API 管理提供商连接、API 密钥、OAuth 流程和连接测试。在 OmniRoute 的 375 个提供商目录中列出、添加、更新、移除和测试 AI 提供商集成。

身份验证

所有请求都需要有效的 Bearer 令牌或会话 Cookie。通过 POST /api/auth/login 获取令牌，或在本地开发环境中配置 REQUIRE_API_KEY=false。

端点

负载

如需详细的请求和响应架构，请参阅完整的 OpenAPI 规范：GET /api/openapi/spec 或 docs/openapi.yaml。

其他端点

POST /api/providers/{id}/refresh

轮换／刷新 OAuth 令牌，或重新验证提供方连接的凭据。在令牌过期后，或需要续期凭据但不想删除连接时，此操作很有用。

curl -X POST https://localhost:20128/api/providers/{id}/refresh \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'
GET /api/provider-metrics

获取所有提供方连接的汇总用量和性能指标（请求数、错误率、延迟百分位数、令牌用量）。供仪表板和 Auto-Combo 评分使用。

curl https://localhost:20128/api/provider-metrics \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN"

响应示例：

{
  "providers": [
    {
      "id": "my-openai",
      "requestCount": 1240,
      "errorRate": 0.02,
      "p50LatencyMs": 340,
      "p99LatencyMs": 1200,
      "tokensIn": 500000,
      "tokensOut": 250000
    }
  ]
}
GET /api/providers/health-matrix

返回所有提供方的健康矩阵视图，其中包含各连接的状态、断路器状态和冷却到期时间。可用于调试路由决策。

curl https://localhost:20128/api/providers/health-matrix \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN"

评论

支持 Markdown