认证与 API 密钥

1. 进入 API 密钥 → 创建密钥，填写便于识别的名称。
2. 选择允许模型，按需设置积分上限、有效期、IP 白名单和速率限制。密钥本身不绑定钱包或某一个订阅周期。
3. 请求时系统按账户当前状态自动选择资金来源：有效订阅范围内优先使用订阅积分；没有有效订阅时使用流量积分；订阅不足时仅在你已开启“使用流量积分”后切换。
4. 复制平台密钥到客户端。连接检查只验证认证和模型目录，不代表已经完成真实推理。

权限取交集#

实际可调用模型是平台支持范围、已上架目录、密钥允许范围、订阅权限的交集。GET /v1/models 返回当前密钥可见模型。界面显示名称不能代替返回的精确 id，cl-、lp- 等路由前缀不要自行删除。

密钥额度上限是消费限制，不是充值。钱包赠送、现金余额和订阅额度分别记录；提高密钥上限不会自动增加账户可用额度。

存量密钥与新密钥#

已经配置并仍在使用的旧密钥可以继续调用，不需要因开通、续订或到期重建。部分早期密钥只保存了不可逆校验值，平台无法再次显示完整内容；原客户端不受影响，需要在新设备安装时请新建密钥。新密钥会加密保存可恢复副本，可在登录后复制，也可生成 CodeBuddy / WorkBuddy 的一次性配置包。

CodeBuddy / WorkBuddy 配置包使用独立客户端凭证，动态继承主密钥的状态和模型权限。停用或删除主密钥会同时影响关联客户端。托管配置会定时刷新平台模型；CC Switch 及无法由平台控制缓存的第三方客户端，需要在应用内重新抓取模型或新建会话。