omni-models

omni-models 是 omniroute 项目中的模型管理接口模块，核心用途是查询所有已配置提供商中可用的 AI 模型，帮助使用者集中查看模型清单、解析别名并浏览完整模型目录。

主要能力：

• 列出所有已配置提供商中可用的模型；
• 提供管理视角的模型列表接口；
• 创建或更新模型别名；
• 获取完整模型目录，包含各提供商特定变体；
• 获取 openrouter 目录；
• 测试单个模型以及批量测试全部模型；
• 查询指定模型的详细信息。

使用方式（接口与示例）： 所有请求需要有效的 Bearer 令牌或会话 Cookie。可通过 POST /api/auth/login 获取令牌，或在本地开发时设置 REQUIRE_API_KEY=false。

• 获取可用模型列表： GET /api/v1/models curl https://localhost:20128/api/v1/models
  -H "Authorization: Bearer $OMNIROUTE_TOKEN"

• 管理端模型列表： GET /api/models curl https://localhost:20128/api/models
  -H "Authorization: Bearer $OMNIROUTE_TOKEN"

• 创建或更新模型别名： POST /api/models/alias curl -X POST https://localhost:20128/api/models/alias
  -H "Authorization: Bearer $OMNIROUTE_TOKEN"
  -H "Content-Type: application/json"
  -d '{}'

• 获取完整模型目录： GET /api/models/catalog curl https://localhost:20128/api/models/catalog
  -H "Authorization: Bearer $OMNIROUTE_TOKEN"

• 获取 openrouter 目录： GET /api/models/openrouter-catalog curl https://localhost:20128/api/models/openrouter-catalog
  -H "Authorization: Bearer $OMNIROUTE_TOKEN"

• 测试模型： POST /api/models/test curl -X POST https://localhost:20128/api/models/test
  -H "Authorization: Bearer $OMNIROUTE_TOKEN"
  -H "Content-Type: application/json"
  -d '{}'

• 测试全部模型： POST /api/models/test-all curl -X POST https://localhost:20128/api/models/test-all
  -H "Authorization: Bearer $OMNIROUTE_TOKEN"
  -H "Content-Type: application/json"
  -d '{}'

• 查询单个模型： GET /api/v1/models/{model} curl https://localhost:20128/api/v1/models/{model}
  -H "Authorization: Bearer $OMNIROUTE_TOKEN"

请求与响应结构可参考完整 OpenAPI 规范（GET /api/openapi/spec 或 docs/openapi.yaml）。

适用场景： 适合需要在多提供商环境下统一查看、核对与测试可用 AI 模型的开发者与运维人员，也适合通过别名机制对模型名称进行适配和映射。

限制与缺失信息： 资料未提供具体收费、价格、平台支持范围、性能效果或部署步骤等信息，相关内容暂未提供。