BYOK:自备上游 Key

BYOK(Bring Your Own Key) 指租户自备在 OpenAI、Anthropic、Google、DeepSeek 等服务商官方平台申请的上游 Key。XSI Control 为每个租户提供独立的 Key 池、路由配置、价格与账号树:上游 Key 的所有权与模型账单始终属于租户,XSI Control 负责加密托管、路由与治理。

两类凭证

凭证来源用途
上游 Key(Provider Key)租户在服务商官方平台申请加密保存在租户的 Key 池中,只用于转发本租户账号的请求
XSI API Key(sk-Xvs 开头)XSI Control 为每个账号签发调用方的身份凭证,承载额度、白名单、限速与用量记录

应用只持有 XSI API Key,不接触上游 Key。成员离开或应用下线时,停用对应的 XSI API Key 即可,上游 Key 无需轮换。

为什么选择 BYOK

  • 所有权不变:上游 Key 在服务商平台申请、轮换与吊销,也可以随时在配置管理中更换或删除。
  • 账单直达:模型调用费用由服务商直接与租户结算,原始账单可在服务商后台核对。XSI Control 的套餐见价格。
  • 统一入口:多家服务商、多把 Key 汇入一个入口,按 Level 分组,支持粘性会话、自动重试与故障转移。
  • 分发与审计:通过账号树为团队、项目或客户分配额度、模型与权限,用量按账号与模型可查。
  • 没有锁定:调用方使用官方协议与 SDK,只改 base_url;迁移时把 base_url 换回服务商或自行部署的 XSI 即可。

安全模型

  • 每个租户拥有一把随机生成的租户密钥,上游 Key 使用租户密钥以 XChaCha20-Poly1305 加密后入库。
  • 租户密钥再用各账号自己的 API Key 加密,保存在账号记录中;服务端不保存可直接解开租户密钥的明文材料,数据库被单独拿走时,上游 Key 无法直接解密。
  • 不同租户的 Key 池相互隔离,只服务本租户账号的请求。
  • 转发时剥离调用方凭证,上游只看到租户自己的 Key。
  • 结合 IP、接口与模型白名单、额度和限速,控制谁能调用、能用多少。

详见《架构》中的加密模型一节。

开始使用

  1. 在 a.xsicontrol.com 注册并激活,获得租户所有者 API Key。
  2. 登录配置管理控制台,在“模型服务”中录入上游 Key,并为其设置 Level。
  3. 按需配置模型映射、Level 映射与价格。
  4. 在账户管理控制台(m.xsicontrol.com)为成员、应用或客户创建子账号与额度。
  5. 应用把 base_url 指向 https://api.xsicontrol.com,使用子账号的 XSI API Key 调用。

完整步骤见《快速开始》。

常见问题

XSI Control 会使用或转售我的上游 Key 吗?

不会。上游 Key 只用于转发本租户账号发起的请求。XSI Control 不提供共享 Key 池,也不会把租户的 Key 用于其他租户。

为什么还需要 XSI API Key?

上游 Key 只证明“调用哪家服务商”,XSI API Key 则标识“谁在调用”:它决定请求归属哪个账号、走哪个 Key 池、受哪些额度与白名单约束,并记录用量。这样,成员与应用之间可以细粒度地分配权限,而上游 Key 始终只有一份、集中管理。

以后想迁移怎么办?

上游 Key 始终在服务商平台,可以直接用于新的环境;应用侧只需修改 base_url 与 Key。需要私有化时,也可以自行部署 XSI,沿用同一套接入方式。

相关文档