模型连接
如何安全地添加自己的模型 API Key（BYOK）？
在本机模型设置中录入供应商 Key，核对地址和模型 ID，并避免把密钥放入公开内容。
由 路墨 Lumoswitch 产品团队维护
简要回答
本机 BYOK 凭据保存在设备并用于直连供应商；在线托管 Key 与本机 Key 是不同连接路径。
本机 BYOK 应该在哪里添加？
在桌面端打开“模型 → 本机”，进入“管理 API Key”，选择供应商并填写它提供的 API Key；必要时补充自定义地址和模型 ID，再保存。编辑已有项时，密钥字段不会回填；留空表示保留原密钥。保存前核对供应商、协议、地址和模型名，避免把凭据发往错误端点。
本机密钥会上传到 Lumoswitch 云端吗？
本机 LiteLLM 配置的供应商请求由本机运行时直接发送，供应商 Key 使用系统安全存储加密并留在设备上；本机 Key 管理不会调用云端创建 Key 或配额接口。在线托管 BYOK 仅允许已有 Key 继续使用，不再支持新增或替换；新 Key 请添加到本机。
添加后模型仍不能调用怎么办？
先确认 Key 未过期、账户在供应商侧有权限且所选模型 ID 对该端点有效。再核对地址是否含正确 API 前缀、协议类型是否匹配，并检查供应商侧余额或速率限制。不要把 Key 粘贴到截图、社区帖子或支持工单；如已暴露，应在供应商后台撤销并创建新 Key。