上游接入

上游是 Lumoswitch 实际请求模型的服务来源。上游接入页用于托管渠道 API Key、维护 Base URL、管理凭证池并执行连接测试。

支持的预设

控制台提供 33 个云端、本地和自定义上游预设，并按当前部署版本与区域展示可用项。完整名称、协议和默认地址见 上游支持矩阵。预设会填充建议 Base URL 和模型检测规则。

新增上游

1. 进入 上游 Key 接入。
2. 点击 接入上游 Key。
3. 选择渠道预设。
4. 填写一个可识别的接入名称，例如“DeepSeek 生产”。
5. 粘贴渠道 API Key。
6. 核对 Base URL。
7. 保存；系统会自动拉取该账号可用的模型。

保存后，密钥会加密持久化。列表页只展示接入信息和健康状态，不显示密钥明文。

Base URL 规则

• 使用渠道预设时，优先保留预设地址。
• 使用 OpenAI-compatible 服务时，Base URL 通常需要包含 /v1。
• Ollama 和 LM Studio 可使用私有地址，但当前 Lumoswitch 实例可能基于安全策略拒绝访问。
• 不要把 Lumoswitch 的下游 Base URL 填到上游配置中，否则可能形成循环请求。

连接测试

单个测试

用于验证指定上游的 Key、Base URL 和基础访问权限。测试结果会记录成功或失败状态与耗时。

一键测试状态

并行测试所有已托管上游的主 Key，并汇总成功、失败数量。适合日常巡检，不建议高频连续执行。

连接测试会向渠道发送轻量请求，可能产生少量额度消耗。

凭证池

一个上游可维护多个 API Key。凭证池用于：

• 将不同账户或额度的 Key 统一管理。
• 设置凭证优先级，数值越小越优先。
• 启用或停用单个凭证。
• 删除已失效凭证。

调整凭证池前，请确保至少保留一个已启用且可用的 Key。

聊天补全测试

除连接测试外，控制台还可以对上游执行聊天补全测试。该测试能验证模型调用链路，但比列表模型测试更可能产生 Token 费用。

常见错误

删除上游前

上游可能已被模型资源和配置 API 引用。删除前请先确认其他上游可以接管流量，并重新检测模型资源。