mcpField
O
omni-models

omni-models

github.com/cheaper-inference开发82.3k1.1k 次安装今天更新
代码仓库

关于 omni-models

omni-models 介绍 OmniRoute 中经过身份验证的模型 API,可查询已配置提供商的模型。它支持目录浏览、筛选列表、模型别名和模型测试。

主要功能

  1. 01列出已配置提供商的模型
  2. 02筛选并分页浏览模型结果
  3. 03查询数量受限的模型列表
  4. 04创建或更新模型别名
  5. 05浏览完整目录和 OpenRouter 目录
  6. 06测试单个或全部模型

适用场景

  1. 01发现 API 密钥可见的模型
  2. 02按能力或上下文筛选目录
  3. 03通过别名解析模型
  4. 04使用测试端点检查模型可用性

安装

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

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

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

详细介绍

概览

查询所有已配置提供方提供的 AI 模型。列出模型、解析模型别名,并浏览包含特定提供方变体的完整模型目录。

身份验证

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

端点

GET /api/v1/models

列出可用模型

返回所有已配置提供方提供的模型。发现筛选条件(capability、min_context、kind、q)为可选项:不使用时,响应保持不变。这些条件会筛选调用方自己的(按密钥过滤的)目录,并在 limit/after 分页之前执行。

curl http://localhost:20128/api/v1/models \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN"
POST /api/v1/models/query

查询模型候选列表

在与 GET /v1/models 相同的目录中筛选候选列表(使用相同的身份验证和按密钥设置的可见范围)。结果按 owned_by 排序,然后按 id 排序,并受 limit 限制(默认值为 20,最大值为 100)。

curl -X POST http://localhost:20128/api/v1/models/query \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'
GET /api/models

列出模型(管理)

curl http://localhost:20128/api/models \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN"
POST /api/models/alias

创建或更新模型别名

curl -X POST http://localhost:20128/api/models/alias \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'
GET /api/models/catalog

获取完整模型目录

curl http://localhost:20128/api/models/catalog \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN"
GET /api/models/openrouter-catalog

获取模型 › OpenRouter 目录

curl http://localhost:20128/api/models/openrouter-catalog \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN"
POST /api/models/test

测试模型

curl -X POST http://localhost:20128/api/models/test \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'
POST /api/models/test-all

测试所有模型

curl -X POST http://localhost:20128/api/models/test-all \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'
GET /api/v1/models/{model}

获取模型 ›

curl http://localhost:20128/api/v1/models/{model} \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN"

请求负载

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

评论

支持 Markdown