换 API 服务商能带走什么？密钥、余额与聊天记录迁移清单

换 API 服务商时，能带走的通常是你掌握的内容和配置，不能默认随之转移的是账户余额、服务端资源和访问权限。即使两边接口格式相似，把地址改掉也不等于迁移完成。先确认数据在哪，再保存可恢复副本，最后切换调用入口。

本文面向使用桌面客户端或自有应用的用户。下面是迁移操作与验收方法，不是某家服务商的迁移实测；不承诺跨平台转账、退款或全部功能兼容。产品文档核对日期为 2026-10-18，实际操作应以你安装的客户端版本为准。

1. 先列清单：哪些能复制，哪些必须重建

同一个“账户”可能混合了客户端登录、API 服务商账户和模型平台资源。不要用一个登录邮箱把它们视为同一套数据。

对象	应保存什么	切换时的处理
API Key	密钥名称、权限、使用它的应用；完整值放在安全存储中	在新服务商创建新凭据，不能拿旧 Key 试探新地址
余额、赠送额度、订单	实付与赠送分别记录，保留有效期、订单及退款规则	留在原账户单独结算；只有双方明确支持时才讨论转移
提示词与助手配置	系统指令、参数、工具定义、模型选择	复制后逐项核对，新接口可能不支持原字段
对话历史与附件	原始备份、可读导出、附件原文件	导入格式、分支和附件引用需要单独验收
服务端文件与会话	本地源文件、资源用途、旧 ID 与归属账户	不默认 ID 跨服务商可用；按新接口重建并保存映射
知识库	原文、分块设置、嵌入模型、检索基线	确认是否能复用索引；换嵌入模型时按产品要求重建

余额处理与技术切换是两条独立流程。不要为了“迁移余额”把完整密钥、客户端备份或登录验证码交给第三方。若原平台不提供导出，应明确记为缺失项，而不是假定新平台能找回。

2. 同时保留可读导出和完整备份

可读导出用于查阅，原生备份用于恢复。Markdown 或 PDF 能保存文字，不代表能重新导入为包含消息角色、分支、工具结果和附件关系的完整会话。反过来，一个不透明的备份包也不能替代随时可读的关键资料。

以 Cherry Studio 当前官方“数据设置”文档为例，默认完整备份包括对话、助手、知识库、附件、偏好和 Provider 配置，API 密钥也包含在内；精简备份会跳过图片、知识库等数据文件，只保留聊天记录和设置。这是该产品文档说明，不能推定所有客户端都这样处理。

按下面顺序准备：

记录客户端名称、版本、备份时间与备份类型，先暂停会持续写入的任务。
用客户端支持的功能创建完整备份，同时把关键提示词和重要对话另存为可读格式。保留附件原文件，不只保存预览缩略图或临时链接。
把原始备份留在受保护的位置，不发给新服务商客服。需要工单时，另做只含必要字段的脱敏材料。
在独立测试用户或隔离的数据目录恢复一份副本；先关闭同步、自动任务和外部工具，避免恢复出来的旧密钥立即产生调用。若客户端没有安全隔离方式，先核对官方恢复步骤，不直接覆盖唯一工作副本。
抽查一段早期对话、一段有分支的对话和一个附件，确认内容、时间顺序、文件打开与关联都正确。没有用到某项，就明确标为“不适用”。

备份包内含旧 Key 时，即使你后来在客户端删除了 Key，备份里的副本也仍存在。应按密钥的敏感程度保护备份；撤销密钥可以阻止它继续鉴权，但不会抹掉备份中的对话内容。

3. 新增服务商配置，不先覆盖旧配置

保留旧配置作为有期限的回滚参考，给新配置单独命名。把协议类型、Base URL、API Key、模型 ID 当成一组进行核对，不能只替换 URL 而继续发送旧凭据。

例如 OpenRouter 的鉴权文档要求在其平台创建 API Key，并通过 Bearer token 进行鉴权。这说明相同的请求头写法不意味着凭据可以跨平台使用。某些网关另有明确的凭据迁移机制时，也应按其可信文档确认范围，不能凭接口相似自行推定。

除聊天模型外，还要检查默认助手、标题生成、翻译、图片、嵌入、重排和后台任务是否仍引用旧配置。只切换当前对话窗口，可能留下其他调用继续消费旧账户。

做一张配置映射表：旧配置名称 → 新配置名称 → 使用位置 → 已验证功能 → 负责人。表中使用密钥别名，不写完整 Key。优先让一个低风险任务走新配置；确认网络请求的目标主机、结果和费用记录后，再逐个切换其他使用位置。网络记录分享前删除鉴权头和敏感正文。

4. 聊天记录看得见，不等于新模型收到了

迁移后旧对话仍在界面里，只能说明客户端能显示这份历史。下一次请求实际发送多少轮、是否包含系统指令、附件或工具结果，取决于客户端组装上下文的方式。新服务商不会因为你用了同一个邮箱就自动拥有原平台上的历史。

先在隔离副本中放入一段无敏感信息的测试对话，例如“项目代号为蓝杉，交付物为三项检查清单”，再让新配置回答代号和交付物。配合客户端允许查看的请求记录，核对必要历史是否真正被发送。单次答对不是完整迁移证明，还要检查角色、顺序和上下文裁剪；不要把整段私人历史直接转发给新平台来试错。

附件与服务端资源另做判断：

附件能在客户端打开，但请求报资源不存在：检查是否还引用旧服务商的文件 ID，或原临时 URL 已失效；保留源文件后按新接口重新上传。
文本对话正常，知识库检索异常：检查原文和分块是否齐全、嵌入服务是否已切换，不能只测试聊天模型。
换嵌入模型后结果变差：不同模型的向量空间不能直接视为相同，即使维度一样也不代表兼容。Cherry Studio 官方文档要求已有向量的知识库在更换嵌入模型时进入重建流程；先确认新模型可用，再重建并复测固定问题。

若只是换服务商而声称底层嵌入模型不变，也应确认精确版本、维度和处理方式，不凭相同显示名称认定旧索引可直接复用。

5. 用验收表决定切换与回滚

下面是建议执行的检查，不代表本文已经对某家平台完成这些测试。先用非敏感样本和受控预算验证；需要付费调用的项目由你在自己的授权环境中执行。

检查	通过条件	不通过时先做什么
备份恢复	抽查对话、分支、附件能恢复或已记录不支持项	保留原副本，补齐缺失数据
新配置鉴权	请求确实发往新主机并使用新凭据	检查配置绑定，不把旧 Key 发到新站
历史续聊	必需的上下文按正确角色和顺序进入请求	查上下文裁剪与导入格式
文件与知识库	文件可用，固定问题能检索到正确原文	查资源 ID 映射、解析和索引
实际工作流	所需格式、流式输出或工具功能通过任务验收	保留未迁移任务，查具体能力支持
账单与旧流量	新调用可关联记录，旧账户无非预期新增调用	查默认模型、队列、后台任务和重试

为切换设定一个明确截点，记录当时正在执行、已完成和状态未知的任务。先停止旧入口接收新任务，再等待在途任务结束或查清结果，避免在新平台把同一项外部动作执行两次。

回滚也不只是恢复 URL：切换后新增的对话、上传文件和任务结果要保留；不要用旧备份覆盖掉新数据。已经执行的发信、写入或付款动作不能靠换回模型撤销。状态不明时先人工核对执行记录，再决定是否重试。任务本身的验收设计可参照按任务验收 AI 模型。

6. 迁移结束后关闭旧入口

完成关键任务验收并经过与你的定时任务周期相匹配的观察期后，再撤销不再使用的旧密钥。若怀疑泄露，应立即撤销，不为了回滚继续保留危险凭据。凭据保管可参照API Key 安全指南。

最后检查客户端默认项、服务器环境变量、自动化任务及团队成员配置；在旧平台支持的情况下关闭不需要的自动充值或续费，并保存结算记录。退款资格、到账时限和数据删除范围分别以原平台条款及处理结果为准。删除本地服务商配置不等于注销远端账户，也不等于删除远端日志。

迁移完成的判断是：重要内容有可恢复副本，新工作流通过验收，旧调用停止，未结余额与保留数据都有后续处理记录。某个聊天窗口能回复，只完成了其中一步。

参考资料（2026-10-18 核对）：Cherry Studio 数据设置、Cherry Studio 模型与检索设置、OpenRouter 鉴权。本文没有执行真实付费 API 调用，也没有实际迁移用户数据。