术语表
产品与部署
| 术语 | 说明 |
|---|---|
| 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,加密存储 |
| Provider | Provider Key 的上游基础 URL,例如 https://api.openai.com |
| Level | Key 池分组编号 |
| Key 池 | 同一租户、同一 Level 的 Key 集合,轮询使用 |
| 模型映射(MODEL_MAPPER) | 把请求模型改写为上游模型 |
| Level 映射(LEVEL_MAPPER) | 把上游模型路由到某个 Level |
| 模糊匹配 | 未定价的模型名被匹配到同家族、版本最接近的已定价模型 |
| 粘性会话 | 同一会话固定使用同一个 Key,提高缓存命中率 |
| 休眠(Sleep) | Key 因可重试错误暂时退出轮询,到期后自动恢复 |
| 分组切换(SWITCH_OVER) | 某模型持续失败时,临时把它切换到备用 Level |
| 模型故障替换(MODEL_FAILOVER) | 某模型持续失败时,临时把它替换为备用模型 |
访问控制
| 术语 | 说明 |
|---|---|
| AllowIPs | IP 与 CIDR 白名单 |
| Resources | 接口路径白名单,按前缀匹配 |
| AllowModels | 模型白名单,支持通配 |
| AllowLevels | 允许跨组重试的 Level 集合 |
| ModelLimits / MODEL_LIMITS | 账号级 / 租户级的模型限速 |