模型资源

模型资源是配置 API 可选择和调度的模型实例。它可以是平台直接提供的平台模型，也可以是从已接入上游检测得到的接入模型。

模型资源从哪里来

平台模型 ──────────────────────────┐
                                  ├─> 模型资源 -> 配置 API 候选 -> 调度
已接入上游 -> 模型检测 -> 接入模型 ─┘

平台模型和接入模型只在提供来源上不同，下游定位完全相同。它们都不会绕过配置 API、调度规则或 Access Key 限制。

同一模型 ID 可能由平台、多个上游或多个凭证提供。Lumoswitch 会把它们视为不同的资源来源，便于健康检查和故障转移。

检测模型

1. 进入 模型资源，先查看平台模型。
2. 如已接入上游，再执行模型检测。
3. 等待页面返回已发现数量。
4. 核对模型 ID、来源和健康状态。

检测结果会持久化，不需要在每次请求前重新拉取。当上游 Key、模型权限或渠道可用列表变化时，应重新检测。

资源清单字段

健康状态

目录模型匹配

Lumoswitch 会使用渠道和模型 ID 匹配平台维护的模型目录，用于补全：

• 上下文长度
• 能力标签
• 外部目录参考价格（仅用于目录展示，不参与实际扣费）
• 目录状态

模型目录是平台级数据，普通用户可以查看匹配结果，但由管理员统一维护目录模型。

与配置 API 的关系

创建配置 API 时，选择的是平台模型或接入模型资源，而不是直接领取某个模型的 Key。对外暴露的模型名称可以与实际模型 ID 不同。

例如：

对外模型：lumos-chat
  -> 候选资源 1：DeepSeek / deepseek-chat
  -> 候选资源 2：OpenAI / gpt-4o-mini

没有检测到模型

1. 确认平台当前是否提供可用的平台模型。
2. 使用接入模型时，在上游页面执行连接测试。
3. 确认渠道 Key 有权访问模型列表和目标模型。
4. 检查 Base URL、渠道账户配额、组织和地域限制。接入模型不受 Lumoswitch 账户余额限制。
5. 即使没有拉到模型也可以继续浏览快速开始；真正调用前仍需为配置 API 添加健康候选。