迁移与过渡说明

适用角色:主用户、子用户 更新日期:2026-08-06

如果你在老版控制台已有账户,本文便于区分:账户变成了什么、余额还在不在、原来的 Key 还能不能用、调用方式要不要改


一、最关心的三件事

你的疑问 结论
我的账户变成什么了? 老版的"租户 / 账户"升级为主用户,能力更强,无需重新注册
我的余额还在吗? 。余额原样保留在积分余额(总额度池)这一层
原来的 API Key 还能用吗? 。老 Key 继续有效,调用不中断

本次升级调整了账户和权限的表达方式,不迁移账户数据;原有余额和 API 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/kimi-k3),但老的调用方式继续兼容

你的调用名 路由行为
模型名称(如 deepseek-v4-flash 走你这把 Key 绑定的路由分组:和老版一致
带分组标识(如 A2C4E6G8/deepseek-v4-flash 直接点名走某个分组:新方式,更灵活(需主用户开启"分组标识路由")
  • 老客户端、老脚本零改造:继续用模型名称即可,行为不变。
  • 想用新方式:如果主用户开启了"分组标识路由",可在「调用指南」页复制带分组标识的完整调用名。开关未开时,带分组标识的调用会被拒绝,但模型名称调用照常。

调用方式详解见 开发者指南 · 调用指南与路由说明


四、几个会变化的体验点

4.1 Key 与分组的关系更明确

新建 Key 时需要为它选定一个路由分组(系统会预选第一个可用分组);之后用模型名称调用,就走这个分组,和老版"每 Key 一个分组"体验一致。已有的老 Key 仍按其原分组工作,不受影响。

详见 API Key 与路由分组

4.2 成员自动升级为"子用户"

老版的成员自动升级为子用户,无需手动重建:

  • 老成员的登录方式不变(仍用原邮箱 + 密码登录),无需重新激活
  • 新版为子用户补充了业务身份(用户名、投递邮箱),主用户可在「子用户管理」页编辑补充
  • 老成员名下的 Key 自动归属到对应的子用户下,无需重新分发

只有新创建的子用户需要用激活码注册。已有的老成员是平滑升级的。

4.3 "模型组"统一改称"分组"

老版的"模型组"在新版中统一称为分组

  • 名称和配置保持不变,只是称呼从"模型组"改为"分组"
  • Key 绑定的分组自动对应,老 Key 仍按其原分组工作
  • 分组的管理和维护由平台统一负责

4.4 子用户可自助建 Key

子用户可在「API Key」页自助创建 Key,路由分组只能在主用户授权范围内选;主用户也可代建分发。子用户名下全部 Key 共享同一个额度池上限、消费扣总额度池。详见 子用户管理

4.5 可用模型范围由两道闸决定

哪些分组 / 模型可用,由组织分组授权、子用户分配和 Key 绑定决定。如果发现某些模型用不了,依次检查组织授权、子用户分配、Key 绑定和分组状态,见 模型可用范围与分组授权


五、迁移期注意事项

  • 平滑上线:新体系支持灰度,迁移过程中老数据走原逻辑、新能力逐步开放,调用不中断。
  • 如果菜单或账户名称与旧版不同,可先对照本页确认角色映射;余额或调用异常请联系平台。
  • 保留好订单与凭证:历史订单与付款凭证在「我的订单」中可查、可下载,见 发票与凭证

六、常见问题

Q:我需要重新注册账户吗? A:不需要。老账户自动升级为主用户,直接登录即可。

Q:余额会不会在迁移中丢失? A:不会。余额保留在总额度池(原账户)层,迁移不涉及资金搬迁。

Q:我的脚本还在用 deepseek-v4-flash 这样的模型名,要改吗? A:不用改。模型名称继续走你这把 Key 绑定的路由分组,行为和老版一致。

Q:新版建 Key 怎么选分组? A:新建时选一个路由分组即可(默认已预选第一个可用分组)。老 Key 不受影响;新 Key 的配置见 API Key 与路由分组

Q:原来的成员去哪了? A:他们成为你组织名下的"子用户",在「子用户管理」里可查看和管理。