术语表

本页列出文档中常见的关键术语，便于团队达成一致理解。

核心概念

BYOK (Bring Your Own Key)：携带您自己的密钥。用户自主管理上游 AI 服务商的 API Keys，系统仅作为安全代理，不提供付费密钥池。
Provider Key / 上游密钥：用户在 OpenAI、Anthropic、DeepSeek 等官方平台申请的原始 API Key，由用户添加到 XAI 系统中并加密存储。
XAI API Key / 虚拟密钥：XAI 系统分配给用户的专属密钥（格式：sk-Xvs...），用于调用 XAI 统一 API 入口。
零中间费用 (Zero Markup Pricing)：API 调用费用直接由用户的官方账户扣除，XAI 不收取任何加价或服务费。
端到端加密 (End-to-End Encryption)：Provider Keys 使用用户专属密钥加密存储，采用 ChaCha20-Poly1305 算法，系统不设超级管理员。

账户体系

主账户 (Owner)：一级账户，拥有其后代用户与密钥的管理权限。
后代用户 (Descendants)：主账户的子账户树中的任意下级用户，详见《用户层级》。
DNA：用户谱系路径（如 .1.42.），用于快速筛选某个族群的用户。
档位 (Gear)：影响路由/漂移策略的用户属性之一。
层级 (Tier)：计费/权限分层的用户属性之一。

路由与密钥管理

等级 (Level)：密钥池与模型路由的抽象层，用于分层承载与切换。用户可将不同的 Provider Keys 分配到不同 Level。
密钥池 (Key Pool)：同一 Level 下的多个 Provider Keys 集合，系统自动轮询使用以分散请求压力。
模型映射 (Model Mapper)：将请求模型别名重写为目标模型的映射（如 gpt-4=gpt-4-turbo），支持用户级/主账户级配置。
Level 映射 (Level Mapper)：将模型匹配模式映射到某个 Level（如 claude*=2），用于路由到对应密钥池。
休眠 (Sleep)：发生错误后（如 429、5xx），密钥暂时退出轮询，等待一段时间后再加入。
故障切换 (Switch Over)：在当前 Level 不可用时，按映射表切换到其它 Level。

安全与权限

资源白名单 (Resources)：允许访问的 API 路径集合（如 /v1/chat/completions）。
模型白名单 (AllowModels)：子账户允许调用的模型列表。
IP 白名单 (AllowIPs)：允许调用 API 的 IP 地址或 CIDR 范围。
加密密钥 (Encryption Key)：每个用户专属的 32 字符密钥，用于加密该用户的 Provider Keys。

计费与限速

因子 (Factor)：费率系数相关的用户属性。
费率倍率 (Rates)：对模型定价的倍率系数。
模型限速 (Model Limits)：按模型维度的速率限制（RPM/RPH/RPD、TPM/TPH/TPD）。
RPM/RPH/RPD：每分钟/小时/天的请求上限（Requests Per Minute/Hour/Day）。
TPM/TPH/TPD：每分钟/小时/天的 Token 上限（Tokens Per Minute/Hour/Day）。
信用额度 (Credit Balance)：用户的预付卡片余额，用于内部计费统计（与上游官方账单独立）。

相关文档：