关于 omni-models
omni-models 介绍用于发现和查询已配置提供商模型的 OmniRoute API,面向需要筛选目录或管理模型别名的客户端和管理员。
主要功能
- 01列出各提供商可用模型
- 02筛选和分页获取模型结果
- 03查询数量受限的模型候选列表
- 04创建或更新模型别名
- 05获取完整模型目录
适用场景
- 01查看 API 密钥可访问的模型
- 02按能力或上下文长度筛选模型
- 03为应用整理候选模型列表
- 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