关于 omni-models
omni-models 介绍 OmniRoute 中经过身份验证的模型 API,可查询已配置提供商的模型。它支持目录浏览、筛选列表、模型别名和模型测试。
主要功能
- 01列出已配置提供商的模型
- 02筛选并分页浏览模型结果
- 03查询数量受限的模型列表
- 04创建或更新模型别名
- 05浏览完整目录和 OpenRouter 目录
- 06测试单个或全部模型
适用场景
- 01发现 API 密钥可见的模型
- 02按能力或上下文筛选目录
- 03通过别名解析模型
- 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