API 密钥管理

API 密钥是调用凭证。持有人可能消耗你的可用额度，因此应按密码级别保管。

创建密钥

1. 登录后进入 API 密钥。
2. 点击创建，为密钥起一个能区分用途的名称，例如 desktop-chat、backend-production。
3. 选择需要的分组，确认模型可用。
4. 根据界面设置有效期和额度；测试用途建议使用有限额度。
5. 保存并复制完整密钥，填入可信客户端或服务端私密配置。

不同账户或版本可能提供不同字段，以当前页面为准。若有模型限制或 IP 限制，可按实际使用范围收紧。不要自行改写、删减密钥前缀。

一套应用一枚密钥

为本地测试、生产服务和第三方工具分别创建密钥，方便定位消费、单独撤销和控制权限。不要为了省事把同一枚无限额度密钥交给多人使用。

密钥额度与账户余额是两项限制。修改密钥额度不是向钱包充值，设置无限额度也不会获得免费用量。

轮换与停用

正常轮换时，先创建新密钥，在应用中替换并验证，再停用旧密钥。发现泄露时优先立即停用旧密钥，不要等待轮换窗口。

如果界面只有删除操作，删除后需要重新创建；不要假设还能恢复原密钥。清理客户端设置、日志和公开仓库中的泄露副本，删除聊天消息不能撤销已经泄露的凭证。

密钥报错时先看什么

现象	检查项
401 / Invalid token	是否复制完整，是否使用本站密钥，有无过期、停用或多余空格
有余额仍不能用	密钥额度、所选分组、模型权限和账户状态
本机可用，服务器不可用	IP 限制、环境变量、代理与出口网络
模型列表缺少某模型	当前分组和密钥的可见范围，而不是直接换一枚相同配置的密钥

不要用管理凭证替代调用密钥

浏览器 Cookie、登录密码和后台管理令牌不是普通模型调用的替代品。不要把它们填入聊天客户端，也不要为了「查询余额」授予一个工具不必要的账户管理权限。