术语表

产品与部署

术语说明
XSI源码开放、商业授权的高性能 AI API Router,即本项目
数据面 / 控制面模型调用接口 / 账号、Key、配置与价格管理接口,二者共用同一个 HTTP 入口
配置管理控制台(Admin)面向租户所有者的控制台:上游 Key、路由、价格与通知
账户管理控制台(Manage)面向所有账号的控制台:用量、账单、子账号、额度与 Key
单租户 / 多租户SINGLE_TENANT 决定自助注册账号加入 root 租户,还是各自成为独立租户
单实例 / 多实例SINGLE_MODE 决定计数与通知在进程内完成,还是通过 Redis 在实例间共享

账号

术语说明
XSI API Key账号的调用凭证,sk-Xvs 开头,共 51 个字符
公开标识(Public Key)pk-Xvs 开头的账号公开标识,用于推荐注册
root平台超级管理员,DNA 为 .
租户所有者(Owner)ID == OID 的账号,拥有独立的 Key 池、配置与价格
管理者(Manager)满足管理条件、可以管理后代账号的账号
子账号 / 后代直接下级 / 任意深度的下级账号
DNA账号的祖先 ID 路径,例如 .1.5.,用于判断谱系与筛选分支
Role计费档位:0、1 不检查额度与限速;2 严格;3 订阅
Gear路由模式:大于 0 跟随租户的 Level 映射;小于等于 0 使用账号自己的映射,并可跨组重试
Tier按累计充值计算的等级(0–10),用于筛选

计费

术语说明
额度(Credit)账号余额,以人民币计,由多笔各自带有效期的额度组成
模型 Rates价格表中的换算与加价系数,美元标价模型默认 7
账号 Rates账号的价格倍率,子账号不低于父账号
Factor租户所有者为账号设置的价格系数
XAPI_FEE非模型类操作的固定手续费(默认 ¥0.012),账单中显示为模型 XAPI
按量 / 订阅额度额度的两种资金类型;订阅额度带 [SUB] 标记
冻结(Suspended)余额低于阈值后暂停调用,充值后自动恢复

路由

术语说明
Provider Key租户在上游服务商处持有的 API Key,加密存储
ProviderProvider Key 的上游基础 URL,例如 https://api.openai.com
LevelKey 池分组编号
Key 池同一租户、同一 Level 的 Key 集合,轮询使用
模型映射(MODEL_MAPPER)把请求模型改写为上游模型
Level 映射(LEVEL_MAPPER)把上游模型路由到某个 Level
模糊匹配未定价的模型名被匹配到同家族、版本最接近的已定价模型
粘性会话同一会话固定使用同一个 Key,提高缓存命中率
休眠(Sleep)Key 因可重试错误暂时退出轮询,到期后自动恢复
分组切换(SWITCH_OVER)某模型持续失败时,临时把它切换到备用 Level
模型故障替换(MODEL_FAILOVER)某模型持续失败时,临时把它替换为备用模型

访问控制

术语说明
AllowIPsIP 与 CIDR 白名单
Resources接口路径白名单,按前缀匹配
AllowModels模型白名单,支持通配
AllowLevels允许跨组重试的 Level 集合
ModelLimits / MODEL_LIMITS账号级 / 租户级的模型限速

相关文档