omni-providers 是 OmniRoute 中用于管理 AI 提供商连接的 REST API 能力集合，主要用途是对接多来源模型服务商并集中维护其连接与凭据状态。
【主要能力】 支持列出、查看、新增、更新、删除提供商连接，并对指定连接执行测试；可管理 API 密钥与 OAuth 登录流程，支持 Claude、Codex、AGY 等认证文件的导入、批量导入、ZIP 解压提取与本地应用，也支持导出认证信息。提供模型相关接口，如获取提供商模型列表、同步模型、校验并添加模型。另提供批量测试、批量操作、连接校验、参数过滤器、拦截规则、别名配置、令牌刷新、额度窗口查询等端点。健康与指标方面，可获取健康矩阵（含各连接状态、熔断状态和冷却到期时间）以及聚合用量与性能指标（请求数、错误率、P50/P99 延迟、Token 用量）。
【使用方式】 所有请求需携带有效 Bearer 令牌或会话 Cookie，令牌可通过 POST /api/auth/login 获取；本地开发可配置 REQUIRE_API_KEY=false 关闭校验。核心端点包括 GET/POST /api/providers、GET/PATCH/DELETE /api/providers/{id}、POST /api/providers/{id}/test、GET /api/providers/{id}/models、POST /api/providers/test-batch 等。请求与响应结构可参考 GET /api/openapi/spec 或 docs/openapi.yaml。示例调用：curl -X POST https://localhost:20128/api/providers/{id}/refresh -H "Authorization: Bearer $OMNIROUTE_TOKEN" -H "Content-Type: application/json" -d '{}'。
【适用场景】 适合需要在 OmniRoute 中统一接入和管理多家 AI 提供商、维护密钥与 OAuth 凭据、批量导入认证文件、巡检连接健康状态、同步模型清单以及为仪表盘或路由评分提供指标数据的开发与运维工作。
【限制】 资料仅列出接口与部分示例，未提供各端点的完整请求参数字段、返回结构细节、错误码说明、速率限制、权限分级及具体兼容的提供商清单；375 家提供商目录为资料所述数字，具体支持范围暂未提供。价格、部署要求与运行环境限制暂未提供。