API 参考
export LUMOSWITCH_BASE_URL="https://api.lumoswitch.com/v1"
export LUMOSWITCH_API_KEY="创建配置时仅显示一次的 Access Key"OpenAI 请求使用 Authorization: Bearer $LUMOSWITCH_API_KEY。配置还可开放统一 Anthropic Messages 与 Gemini generateContent 路径，完整列表见协议与兼容性。所有已启用格式共用同一 Access Key、模型白名单、限额与记账。
curl "$LUMOSWITCH_BASE_URL/chat/completions" \
-H "Authorization: Bearer $LUMOSWITCH_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"your-client-facing-model-name","messages":[{"role":"user","content":"Say hello."}]}'stream: true 使用 Server-Sent Events。使用故障转移时，全部候选都必须支持请求使用的工具、视觉、结构化输出、Embedding 或其他模型能力。
| HTTP | 含义 |
|---|---|
| 400 | 所选下游格式的请求无效 |
| 401 | Key 缺失、错误、已撤销或被阻断 |
| 403 | 模型或策略拒绝 |
| 404 | 对外模型或公开路径不存在 |
| 408 | 请求超时 |
| 413 | 请求体超过该路径上限 |
| 415 | 该路径不接受当前 MIME 类型 |
| 422 | 请求无法处理 |
| 429 | Key、Team 或渠道限额触发 |
| 5xx | Lumoswitch Runtime 或上游不可用 |
本地模型接入
将 Ollama 或 LM Studio 本地模型接入 Lumoswitch，配置控制面与推理运行时均可访问的 Base URL，完成连接测试、模型发现和聊天验证。了解 localhost 在宿主机、容器与远程服务器中的差异，排查私有地址限制、空模型列表及连接失败，并通过受控内网、VPN 或安全隧道保护模型服务。
安全与数据处理
了解 Lumoswitch 的凭证保护与数据处理边界，区分账号密码、Access Key 和上游 API Key 的用途，确认控制面、推理运行时与模型服务商分别处理哪些数据。查阅用量元数据、客户端本地配置、上游地址限制和最小权限建议，并按泄漏处理步骤轮换密钥、撤销会话，评估模型请求中的敏感信息与渠道数据政策。