术语表

本页解释文档中的常用术语,便于团队统一理解。

核心概念

  • XSI API Key:XSI 分配给每个账户的密钥(格式:sk-Xvs...),用于通过 XSI 的统一入口调用模型。
  • Base URL:模型调用共用的地址 https://api.xsirouter.com,兼容 OpenAI、Claude、Gemini 等官方协议;使用该地址和 XSI API Key 即可接入。
  • 额度 (Credit):账户余额,以人民币计价(¥1 = 1 额度),通过充值或购买套餐获得。
  • 套餐与 Factor:套餐对应一条上游渠道;Factor 是价格系数。调用按模型广场价格乘以 Factor 扣费,默认系数为 1,渠道套餐的系数可能更低(如 0.6)。
  • Provider Key / 上游密钥:平台在 OpenAI、Claude、DeepSeek 等官方平台使用的原始 API Key,由平台加密托管,用户无须持有。
  • 端到端加密 (End-to-End Encryption):上游密钥由平台加密存储,只在授权的调用链路中使用。

账户体系

  • 账户 (Account):在 m.xsirouter.com 注册的账户,用 XSI API Key 调用模型,并在控制台管理余额、用量与套餐。
  • 子账户 (Sub-account):满足条件的账户可以在控制台创建下级账户,为成员或项目分发额度。
  • 后代用户 (Descendants):账户的子账户树中的任意下级用户,详见《用户层级》。
  • DNA:用户谱系路径(如 .1.42.),用于快速筛选某个族群的用户。
  • 继承 (Inheritance):上级账户创建和管理子账户时,把自己的治理边界(可用模型、限额、价格等)施加到子账户的机制。
  • 运营方 (Owner):通过管理后台配置上游密钥、渠道与价格的平台根账户;普通账户使用用户控制台。

路由与密钥管理

  • 等级 (Level):上游渠道(密钥池)的分组,用于分层承载与切换;不同套餐可能对应不同的 Level。
  • 密钥池 (Key Pool):同一 Level 下多个上游密钥的集合,系统自动轮询使用以分散请求压力。
  • 模型映射 (Model Mapper):将请求模型名重写为目标模型(如 gpt-4=gpt-4-turbo),可在账户级或平台级配置。
  • 休眠 (Sleep):发生错误后(如 429、5xx),密钥暂时退出轮询,等待一段时间后再加入。
  • 故障切换 (Switch Over):当前 Level 不可用时,按映射表切换到其他 Level。

安全与权限

  • 访问控制 (Access Control):用于约束账户请求来源、能力范围和操作范围的治理机制。
  • 白名单 (Allowlist):只允许符合规则的来源、能力或操作通过的控制方式。
  • 安全保护材料 (Protected Security Material):平台内部用于保护敏感凭证的安全材料,普通用户无须感知其具体形态。

相关文档: