管理多个密钥：命名、切换与删除

为什么会需要多把密钥

同一提供商下持有多个账号是常见状态：工作账号与个人账号分开、免费额度用完换新号、按项目分账单、新旧密钥轮换。Agora 支持一个提供商下存储多个命名 API 密钥，不必每次手动替换。

操作方式

1. 进入「设置 → Providers」，选中目标提供商；
2. 在密钥区域依次添加多个密钥，每个都可以命名区分（如「主力」「备用」「测试」）；
3. 密钥列表每行前面有一个单选按钮，点中哪行，哪把就是当前活跃密钥；
4. 不再需要的密钥可以单独删除，不影响其他密钥。

切换密钥就是点一下单选按钮，立刻生效，不需要重启对话或重新同步模型。

搭配使用的两个技巧

• 与归档联动的注意点：导出.agora 归档时如果勾选了密钥类别，所有密钥都会进包且包内不加密——多密钥用户导出前尤其要想清楚这一点；
• 与本地模型共存：多密钥只影响云提供商；本地 GGUF 模型不占密钥位，可以放心混用。

排查思路

换了活跃密钥后对话突然报错？按这个顺序查：

1. 确认选中的单选按钮确实是想用的那把——多密钥并存时容易看串行；
2. 换回原来的密钥再试一次，判断是密钥问题还是配置问题；
3. 密钥本身的额度与状态去提供商后台核对。

更完整的排错清单在密钥连不上怎么办。

相关页面

• 第一把密钥的完整流程，见添加第一个 API 密钥；
• 密钥在设备上的加密方式，见隐私边界。