上游接入
上游是 Lumoswitch 实际请求模型的服务来源。上游接入页用于托管厂商 API Key、维护 Base URL、管理凭证池并执行连接测试。
支持的预设
Lumoswitch 当前内置了以下上游预设：
- OpenAI
- DeepSeek
- OpenRouter
- Qwen / 通义千问
- GLM / 智谱
- Kimi / 月之暗面
- Doubao / 豆包
- Hunyuan / 腾讯混元
- MiniMax
- StepFun / 阶跃星辰
- MiMo / 小米
- SiliconFlow / 硅基流动
- Qianfan / 百度千帆
- Baichuan / 百川
- Yi / 零一万物
- ModelScope / 魔搭
- xAI
- Anthropic
- Gemini
- Ollama
- LM Studio
- Custom OpenAI-compatible
预设会填充建议 Base URL 和协议类型。厂商实际地址变更时，以厂商官方文档和当前控制台预设为准。
新增上游
- 进入 上游 Key 接入。
- 点击 接入上游 Key。
- 选择厂商预设。
- 填写一个可识别的接入名称，例如“DeepSeek 生产”。
- 粘贴厂商 API Key。
- 核对 Base URL。
- 保存；系统会自动拉取该账号可用的模型。
保存后，密钥会加密持久化。列表页只展示接入信息和健康状态，不显示密钥明文。
Base URL 规则
- 使用厂商预设时，优先保留预设地址。
- 使用 OpenAI-compatible 服务时，Base URL 通常需要包含
/v1。 - Ollama 和 LM Studio 可使用私有地址，但当前 Lumoswitch 实例可能基于安全策略拒绝访问。
- 不要把 Lumoswitch 的下游 Base URL 填到上游配置中，否则可能形成循环请求。
连接测试
单个测试
用于验证指定上游的 Key、Base URL 和基础访问权限。测试结果会记录成功或失败状态与耗时。
一键测试状态
并行测试所有已托管上游的主 Key，并汇总成功、失败数量。适合日常巡检，不建议高频连续执行。
连接测试会向厂商发送轻量请求，可能产生少量额度消耗。
凭证池
一个上游可维护多个 API Key。凭证池用于：
- 将不同账户或额度的 Key 统一管理。
- 设置凭证优先级，数值越小越优先。
- 启用或停用单个凭证。
- 删除已失效凭证。
调整凭证池前，请确保至少保留一个已启用且可用的 Key。
聊天补全测试
除连接测试外，控制台还可以对上游执行聊天补全测试。该测试能验证模型调用链路，但比列表模型测试更可能产生 Token 费用。
常见错误
| 错误类型 | 建议检查 |
|---|---|
| 未授权 / 401 | API Key 是否完整，是否属于当前 Base URL |
| 禁止访问 / 403 | 账户、地域、组织或模型权限 |
| 限流 / 429 | 厂商速率限制、并发限制或余额 |
| 找不到模型 | 模型列表接口是否兼容、当前账户是否拥有模型权限 |
| 超时 | Base URL、网络、代理、厂商状态 |
| 无法访问本地模型 | 当前实例是否允许访问私有上游地址 |
删除上游前
上游可能已被模型资源和配置 API 引用。删除前请先确认其他上游可以接管流量，并重新检测模型资源。