术语表
本页解释文档中的常用术语,便于团队统一理解。
核心概念
- 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):平台内部用于保护敏感凭证的安全材料,普通用户无须感知其具体形态。
相关文档: