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