Cherry Studio 如何批量导入多个模型服务商的 API 密钥，哪些情况只能逐条添加？

Cherry Studio 没有面向全部服务商的一键批量导入按钮，能称得上批量的只有同一服务商的多把 Key（英文逗号分隔轮询）和通过配置备份整体恢复这两条路径，跨服务商逐条添加仍是默认方式。只接三五家时手工添加更快；服务商超过十家、或需要在多台设备上复现同一套配置，才值得走文件级批量。把公司账号的密钥分发给多人共用同一个客户端，不属于本文讨论的适用场景。 在 Cherry Studio 的数据结构里，API Key 是挂在「服务商」条目下的字段，而不是一份独立的密钥清单。原因是请求链路按服务商、模型、会话逐层解析，密钥必须依附于某个服务商类型才能被调用。做法是动手前先列一张表，把要接入的厂商按鉴权与请求格式分成 Bearer 鉴权、x-api-key 鉴权、查询参数鉴权三类，同类厂商可以共用一个服务商条目、只改接口地址，需要新增的条目数往往能从十几条压到三四条。 同一服务商下填写多把 Key 时它们会进入轮询队列，这解决的是额度分散，而不是多厂商配置。在支持该写法的版本里，多把 Key 用英文逗号分隔写在同一个输入框内，调用时按顺序取用；限制是并非所有服务商类型都开放这种写法，也不是所有版本都提供。最常见的失败是用了中文逗号或带入多余空格，整串被当成一把 Key，接口直接返回 401。 跨服务商的批量导入，可行路径是导出配置、在编辑器里合并、再恢复导入，而不是去寻找隐藏菜单。步骤上先在设置里做一次备份导出拿到配置文件，再在文本编辑器里按服务商条目补齐密钥与接口地址，最后用恢复功能覆盖当前配置，整个过程不需要联网。恢复前必须再备份一次当前配置，因为覆盖式恢复可能连带清掉会话数据。 配置文件里真正决定能不能跑通的是四个字段：服务商类型、密钥、接口地址和模型列表。服务商类型决定请求体与鉴权头的拼法，写错类型即使 Key 正确也会返回 400；接口地址多了或少了 /v1 是 404 的常见来源；模型列表可以留空让客户端自动拉取，也可以手工填写以固定下拉选项。批量合并时按服务商标识去重，重复条目会让同名服务商出现两份，模型选择界面随之混乱。 批量导入失败多数不是密钥写错，而是版本字段漂移与导入语义差异。客户端升级后配置结构可能新增字段、旧字段被重命名，跨版本导入时被丢弃的部分不会报错，只表现为某个服务商一片空白。另一个坑是导入行为究竟为合并还是覆盖因入口而异，所以先导出、后导入的次序不能颠倒。 如果目的是在同一台机器上维护几套互不干扰的密钥环境，用便携模式或独立数据目录比反复导入导出更省事。便携版把数据目录放在程序同级，复制一份程序目录就得到一套独立配置，切换时不需要改动任何 Key。代价是每套配置要各自维护模型列表与版本更新，磁盘占用和升级操作都会翻倍，适合测试与生产分离，不适合机器资源紧张的场景。 把所有厂商收敛到一个兼容 Chat Completions 规范的统一入口，只需在客户端里配置一次地址和一把 Key，这是批量需求最省事的替代方案。代价是多了一层中间服务，可用性、密钥托管与计费口径都不再直接由你控制，中间层出问题时客户端表现为全部模型不可用，排查难度高于逐个配置。是否采用取决于对链路可控性的要求，而不是配置条数的多少。 导入完成后不要立刻开始对话，先用两次最小请求验证，可以省掉大量误判。第一步拉取模型列表，列表为空说明接口地址或鉴权有问题；第二步发一条只要求返回一个字的请求，看返回码区分：401 指向密钥本身，403 多为账号权限或区域限制，404 指向路径拼写，429 则是额度或频率问题。同一批导入里逐家验证，比全部配完再统一排错更容易定位。 批量粘贴密钥最常见的三类低级错误是空格、中文标点和鉴权前缀重复。从表格或聊天工具复制时会带入首尾空格与不可见字符；全角逗号不会触发分隔，多把 Key 被当成一把；有的文档要求带 Bearer 前缀，有的只要裸 Key，重复添加会得到 401 而不是格式提示。处理办法是粘贴后切到纯文本模式清理，再逐字段确认前缀写法，以及接口地址结尾有没有多余斜杠。 批量导入只解决录入效率，并不解决密钥轮换和权限归属。明文密钥写进会被同步的配置文件、或提交到代码仓库，是现阶段最常见的泄露路径，更稳妥的做法是用系统钥匙串或环境变量托管，配置文件里只保留引用。轮换时要记得撤销旧 Key，否则此前批量导入过的副本仍在持续消耗额度，账单上却看不出是哪台设备在使用。 判断该不该批量导入，标准是服务商数量与配置复现次数，而不是工具本身多寡。三个服务商、一台设备，逐条添加五分钟就能完成，改配置文件反而增加出错面；十家以上厂商、多台设备或多套测试环境，文件级批量与便携目录带来的收益才明显。无论走哪条路径，密钥的计量归属与厂商账号条款始终由使用者负责，批量导入不会改变这一点。