Partner API Key：创建、登录和更换

这把 Key 用来做什么

Partner API Key 用于合作伙伴接口、Partner Client 登录、账号上传和相应出口接入。它代表你在供号端的身份，不是消费端调用模型的本地 Key。

能创建这把 Key 需要相应合作伙伴权限。下载 Partner 发行包和安装受保护更新也会检查供号权限，不是“拿到一个文件就永远不再校验”。

创建与使用

1. 网站打开“合作伙伴控制台 → 合作伙伴 API Key”。
2. 没有现有 Key 时点击“创建合作伙伴 API Key”。
3. 复制 Key，在自己的 Partner Client 登录页面填写。
4. 登录后确认合作伙伴身份，再检查账号列表。
5. 不要把 Key 发给加入你私有房间的消费者；他们使用自己的 User Key。

为什么只能保留一把

当前页面规定每个用户同时只保留一个 Partner API Key。这个限制与客户端实例数量不是同一个概念：不同设备可以有自己的实例标识，但使用的是当前有效的合作伙伴接入凭据。

如果同一上游账号由另一台 Client 重新授权接管，原 Client 的自动维护状态可能改变；不要把“同一个 Partner Key”理解成多个客户端能同时无条件维护同一凭据。

禁用、删除与更换

禁用会使使用该 Key 鉴权的请求失败。删除会让当前 Key 不再可用；按现有规则需要先删除旧 Key 再创建新 Key。

更换前先检查正在运行的 Partner Client、账号自动同步和本机出口。新 Key 创建后，逐个登录需要继续工作的 Client，并核对供号状态。不要先删 Key 后把其他机器的异常当成上游账号故障。

安全和排障

把它放在自己管理的 Client，不写进公开文档、截图和项目仓库。截图示例已隐藏 Key。

提示权限不足时先检查合作伙伴权限；提示凭据无效时检查 Key 是否被禁用或删除；提示客户端实例被停用时到实例管理检查，而不是反复更换上游账号。更多诊断见账号健康。