Cherry Studio 把多个模型服务商放进同一个桌面客户端，用起来方便，但 Key 的管理容易被忽略：谁建的、能用哪些模型、存在哪里、备份会不会带走、离职后是否还在用。本文按创建、配置、存储、同步、轮换、权限和排查的顺序，给出一套可执行的做法。

说明：Cherry Studio 是 CherryHQ 的商标，本文仅作技术讨论，与 CherryHQ 无隶属或合作关系。界面名称、存储方式和功能入口可能随版本变化，请以客户端当前版本和官方文档为准；模型与价格以站内模型价格页为准。

一、先分清三类“Cherry Studio Key”

这个词经常被混用：

  • 客户端或企业平台凭证：用于登录、企业版管理或厂商自有服务，权限和计费由厂商决定。
  • 模型供应商 Key：由 OpenAI、Anthropic、Google 等签发，填进对应服务商字段。
  • 网关 Key：由中商起航 AI 网关这类 OpenAI 兼容服务签发，一个 Key 可调用多家模型。

本文讲第三类。它不用于登录 Cherry Studio，也不能调用客户端厂商的接口。配置时应选择“自定义服务商”或 OpenAI 兼容入口，而不是把网关 Key 填进某个厂商的专用字段。

二、创建 Key：先定用途和上限

不要先建 Key 再想给谁用，顺序反过来会省很多事：

  1. 打开中商起航 AI 网关注册页，完成注册并登录控制台。
  2. 进入 API 密钥页面，新建密钥。
  3. 名称写清使用者、设备和用途，例如 cherry-laptop-daily，不要用 test。
  4. 设置额度上限和到期时间；控制台支持模型范围时，按项目限制可用模型。
  5. 确认账户余额，避免配置完成后才发现无法调用。
  6. 复制 Key 存入密码管理器，不要先发到群聊、文档或工单里。

建好后先用命令行确认 Key、地址和模型三者是通的，再进客户端：

export ZSQH_API_KEY="sk-你的密钥"

curl "https://ai.zhongshangqihang.com/v1/chat/completions" \
  -H "Authorization: Bearer $ZSQH_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"你的模型ID","messages":[{"role":"user","content":"只回复 OK"}]}'

返回中出现 choices 字段，说明请求链路正常。若报 401，先查 Key；报 404，先查 /v1 路径；报模型不存在，先核对模型 ID。

三、在客户端里配置服务商与模型

Cherry Studio 的入口通常是“设置 → 模型服务”。不同版本按钮名称略有差异，但字段基本一致：

配置项 建议填法 说明
服务商类型 自定义 / OpenAI 兼容 不要选厂商专用协议
API 密钥 sk-... 控制台创建的网关 Key
API 地址 https://ai.zhongshangqihang.com/v1 末尾不加斜杠
模型 从列表获取或手动添加 ID 与价格页保持一致

保存后可以点“获取模型列表”，也可以手动添加模型 ID。模型 ID 要区分大小写和版本后缀，类型按用途标注为对话、嵌入、视觉等；具体选项以当前版本为准。配置完成后用“检测”或发一句“只回复 OK”验证。

四、多模型怎么分工

多模型不是把列表填满，而是让每个助手只做一类事：

  • 日常问答：选响应快、成本可控的通用模型。
  • 长文与合同：选长上下文模型，单独建助手，避免与日常对话混在一起。
  • 代码与结构化输出：选代码能力稳定的模型，并确认支持所需参数。
  • 知识库：单独配置嵌入模型；需要重排时再配置重排模型。
  • 敏感内容：优先考虑本地模型，或先明确数据处理边界。

每个助手写清系统提示词，减少重复交代。模型越多，越要避免把整篇文档反复贴进对话，能入库的先入库。

五、Key 存在哪里，备份与同步注意什么

Cherry Studio 把服务商配置和 Key 保存在本机应用数据中。官方文档没有承诺本地存储一定加密，应按敏感文件对待：开启磁盘加密、设置锁屏密码，不要把应用数据目录放进公共网盘或代码仓库。

备份方面，官方文档列出 WebDAV、S3 兼容存储和本地目录三种方式。完整备份包含聊天、助手、知识库、附件和服务商配置，API Key 也会一并包含；精简备份体积更小，但不能完整恢复知识库。官方文档未描述实时多端同步，常见做法是在 A 电脑备份、在 B 电脑恢复。

因此：

  • 备份文件按密钥文件管理，不分享、不放在不可信的共享云盘。
  • 多设备各自建 Key，不要把一个 Key 复制到所有机器。
  • 迁移前先做一次完整备份，恢复后逐项检查服务商、模型和知识库。
  • 团队共用电脑时使用独立系统账户，避免配置互相覆盖。

六、轮换与吊销

建议每 90 天轮换一次，或在成员离职、设备丢失、疑似泄露时立即执行。轮换要“先建新、再切换、后禁用”，不要直接删除旧 Key。

  1. 新建一个权限相同的新 Key，名称加日期后缀。
  2. 在 Cherry Studio 中替换 API 密钥，并检查每个服务商条目。
  3. 发送测试请求，确认网关日志出现新 Key 的调用记录。
  4. 观察错误率和用量，确认没有遗漏的脚本或设备。
  5. 禁用旧 Key，保留一段时间后再删除。

Cherry Studio 支持为一个服务商配置多个 Key 并轮询，适合分散限流压力；但这不等于可以共用 Key，账目和责任人仍要分清。

七、最小权限与团队策略

  • 一人一 Key，一用途一 Key；自动化任务单独建 Key。
  • 能设额度、到期时间和模型范围就都设上，至少设前两项。
  • 通过统一网关接入，保留成员、模型和用量日志，便于对账。
  • 维护台账：只记 Key 名称、持有人、用途、创建与到期时间，不记完整 Key。
  • 每月检查长期未用的 Key、超额 Key 和鉴权失败异常。
  • 把 Key 的创建、交接、禁用写进入职和离职流程。
  • 规定哪些数据允许进入云端模型，敏感项目先评估再使用。
  • 定期复核模型价格，价格和可用模型会调整。

八、故障排查

  • 401 / Invalid API Key：Key 错误、被禁用，或粘贴时带入空格换行。
  • 403：额度用完、权限不足，或模型不在允许范围。
  • 404：API 地址路径不对，检查 /v1 是否重复或缺失。
  • 429：触发限流或达到额度上限，查看控制台用量。
  • 超时或断流：检查代理、防火墙和流式输出设置。
  • 知识库报错：嵌入模型未配置，或网关不提供对应嵌入接口。
  • 恢复备份后不可用：确认服务商配置已恢复，再重新填写或校验 Key。
  • 换 Key 后仍失败：确认保存成功，并在网关日志核对请求是否到达。

常见问题

Cherry Studio 的 API Key 存在哪里，安全吗？

保存在本机应用数据中，具体路径随系统和版本变化。官方文档没有承诺加密，完整备份还会包含 Key。应按敏感文件保护，开启磁盘加密，避免同步到公共位置。

一个 Key 能给多个模型用吗？

通常可以，只要网关允许该 Key 调用这些模型。能否限制模型范围取决于控制台能力；不能限制时，至少用额度上限、到期时间和日志控制影响。

开启 WebDAV 备份会把 Key 传上去吗？

官方文档说明完整备份包含服务商配置和 API 密钥。选择可信的存储位置，开启传输加密，不分享备份文件；对密钥敏感时，可评估精简备份，或先移除密钥再备份。

换电脑后怎么迁移配置和 Key？

先做完整备份，上传到 WebDAV 或 S3，再在新设备恢复；也可以迁移本地备份目录。恢复后检查服务商、模型、知识库和默认模型设置，并为新设备单独建 Key。

Key 泄露后最先做什么？

先禁用或删除 Key 止损，再查异常用量、调用来源和时间段。之后检查备份、仓库、聊天记录和截图，必要时轮换同一环境的其他凭证。

小结

Cherry Studio 的 Key 配置不复杂，难的是长期管理：名称可追溯、额度有上限、存储有保护、备份有边界、泄露能止损。可以先注册中商起航 AI 网关建一个客户端专用 Key，跑通后再按团队策略收紧，并结合模型价格定期复核成本。

相关阅读：