迁移与过渡说明
适用角色：组织（顶层用户）、子用户 更新日期：2026-07-02
如果你在老版控制台已有账户，本文帮你搞清楚：账户变成了什么、余额还在不在、原来的 Key 还能不能用、调用方式要不要改。
一、最关心的三件事
| 你的疑问 | 结论 |
|---|---|
| 我的账户变成什么了？ | 老版的"租户/账户"升格为组织（顶层用户），能力更强，无需重新注册 |
| 我的余额还在吗？ | 在。余额原样保留在组织（原账户）这一层 |
| 原来的 API Key 还能用吗？ | 能。老 Key 继续有效，调用不中断 |
一句话：这是一次平滑的语义升级，不是数据迁移，你的账户、余额、Key 都在原处。
二、账户层级的变化
新版引入了三级账户体系，与 AWS 的 Account → IAM User → Access Key 层级类似：
| 老版 | 新版 | 类比 AWS | 说明 |
|---|---|---|---|
| 租户 / 账户 | 组织（顶层用户） | AWS Account | 称呼变了，账户主体不变，余额保留 |
| 租户管理员 | 组织本身 | Account Owner | 登录的就是组织账户 |
| 普通成员 | 子用户 | IAM User | 组织名下的独立身份，有账号名、邮箱等业务信息 |
| API Key | 子用户 / 组织名下的 API Key | Access Key | Key 归属于某个子用户（或组织本身），用于 API 调用认证 |
简单理解：老版的每把 Key 现在明确归属于一个子用户（或组织本身），就像 AWS 的 Access Key 归属于某个 IAM User 一样。Key 本身没变（格式、用法、绑定的分组都不变），只是在管理层面多了一层"这把 Key 是谁的"归属关系——组织可以看到每个子用户名下有哪些 Key、用了多少额度。
老 Key 会自动归属到组织名下，你不需要做任何操作。如果你之前为不同成员创建了不同的 Key，这些 Key 在子用户管理中仍然可以按人查看。
详细的三层关系见 三级账户体系。
三、调用方式：老 Key 不用改
新版引入了「指纹调用名」（如 5MHXZWKA/gpt-4o），但老的调用方式继续兼容：
| 你的调用名 | 路由行为 |
|---|---|
裸模型名（如 gpt-4o） | 走你这把 Key 绑定的路由分组 —— 和老版一致 |
带指纹（如 5MHXZWKA/gpt-4o） | 按指纹点名分组路由 —— 新版方式，更灵活 |
- 老客户端、老脚本零改造：继续用裸模型名即可，行为不变。
- 想用新方式：到「调用指南」复制带指纹的调用名。两种方式可并存，按需选用。
调用方式详解见 开发者指南 · 调用指南与双路由。
四、几个会变化的体验点
4.1 建 Key 仍是"绑定一个分组"
新版每把 Key 绑定一个路由分组，裸模型名调用时走该分组——与老版"每 Key 一个分组"体验一致。已有的老 Key 仍按其原绑定分组工作，不受影响。另有进阶的「调度分组白名单」（仅组织可配）用于约束带指纹/点名调用。详见 API Key 与路由分组。
4.2 成员自动升格为"子用户"
老版的成员自动升格为新版的子用户，无需手动重建：
- 老成员的登录方式不变（仍用原来的邮箱 + 密码登录），无需重新激活
- 新版为子用户补充了业务身份信息（账号名、邮箱、备注），组织可在「子用户管理」页编辑补充
- 老成员名下的 Key 自动归属到对应的子用户下，无需重新分发
只有新创建的子用户需要通过激活码注册。已有的老成员是平滑升格的。
4.3 "模型组"统一改称"分组"
老版的"模型组"在新版中统一称为分组：
- 老版的模型组名称和配置保持不变，只是称呼从"模型组"改为"分组"
- Key 绑定的分组自动对应，老 Key 仍按其原绑定的分组（即老版的模型组）工作
- 新版分组的管理和维护由平台统一负责
4.4 子用户可自助建 Key
子用户可在「API 密钥」页自助创建 Key，路由分组只能在组织授权范围内选择；组织也可代建分发。子用户名下全部 Key 共享同一个额度上限、扣组织余额。详见 子用户管理。
4.5 可用模型范围由平台按组织配置
哪些分组/模型可用，由平台按组织设定。如果发现某些模型用不了，多半是不在你组织的可用范围内，联系 CloudRouter 调整，见 地区与模型范围。
五、迁移期注意事项
- 平滑灰度上线：新体系支持灰度，迁移过程中老数据走原生逻辑、新能力逐步开放，调用不中断。
- 遇到异常先别慌：如果登录后发现菜单、账户名称与以往不同，多半是已切到新版，按本手册理解即可；余额或调用异常请联系支持。
- 保留好订单与凭证：历史订单与付款凭证在「我的订单」中可查、可下载，见 发票与凭证。
六、常见问题
Q：我需要重新注册账户吗？ A：不需要。老账户自动升格为组织，直接登录即可。
Q：余额会不会在迁移中丢失？ A：不会。余额保留在组织（原账户）层，迁移不涉及资金搬迁。
Q：我的脚本还在用 gpt-4o 这样的模型名，要改吗？ A：不用改。裸模型名继续走你这把 Key 绑定的路由分组，行为和老版一致。
Q：新版建 Key 怎么选分组？ A：和老版一样，为 Key 绑定一个路由分组即可。老 Key 不受影响；新 Key 的配置见 API Key 与路由分组。
Q：原来的团队成员去哪了？ A：他们成为你组织名下的"子用户"，在「子用户管理」里可查看和管理。
联系我们
- 电子邮箱：support_cloudrouter@clouditera.com
- QQ 社群：712273971
- 平台网址：cloudrouter.online