mcpField
O
omni-models

omni-models

github.com/diegosouzapw开发82.9k971 次安装今天更新
代码仓库

关于 omni-models

omni-models 介绍用于发现和查询已配置提供商模型的 OmniRoute API,面向需要筛选目录或管理模型别名的客户端和管理员。

主要功能

  1. 01列出各提供商可用模型
  2. 02筛选和分页获取模型结果
  3. 03查询数量受限的模型候选列表
  4. 04创建或更新模型别名
  5. 05获取完整模型目录

适用场景

  1. 01查看 API 密钥可访问的模型
  2. 02按能力或上下文长度筛选模型
  3. 03为应用整理候选模型列表
  4. 04管理模型别名

安装

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

$npx skills add https://github.com/diegosouzapw/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