配置管理控制台
配置管理控制台(Admin)用于管理租户的上游 Key、路由、价格与通知。它是一个纯静态站点:账号、Key、路由与价格管理直接调用 XSI API,对应本文档中的公开接口;启用支付集成后,商品、订单与收入管理直接调用 XPAY_API。
登录
- 使用 XSI API Key 登录(
sk-Xvs开头,51 位)。控制台通过GET /dashboard/status验证,账号需为租户所有者或具备管理者权限。 - Key 保存在浏览器本地,重新打开页面会自动登录;点击右上角 Exit 清除。
- 登录页提供邮箱注册入口(
POST /x-sign),开启推荐功能时可填写推荐码;URL 中的?ref=会自动填入。 - 右上角
EN/中切换语言;英文界面位于/en/。 - 登录页底部展示
XSI by XABC Labs署名与项目链接。 - 导航栏的广播位与页面右侧的推广卡片是 XSI 的保留展示位,免费使用时须原样保留,见 LICENSE 第 5 条。
导航栏还包括:授权徽标(LICENSE_ID)、打开账户管理控制台的入口、当前账号卡片(R 表示 root)与余额。
AI API
接入说明与示例:系统工作流程、OpenAI 与 Anthropic SDK 示例,以及 Responses、Chat Completions、图片生成与编辑、Messages 的 cURL 示例。示例中的 Base URL 自动填入当前部署的 API 地址,可一键复制。
模型服务
管理本租户的上游 Provider Key,对应《Provider Key API》。
统计卡片:总 Level 数、总 Key 数、活跃 Key 数、休眠 Key 数。
新增 Provider
| 字段 | 说明 |
|---|---|
| Name | 可选备注,如 OpenAI |
| Level | 必填,Key 池分组编号;系统会根据已存在的同类 Provider 自动建议 |
| 常用 Provider | 32 个预设(OpenAI、Claude、Gemini、xAI、DeepSeek、Azure OpenAI、Vertex AI、阿里云、火山方舟、智谱、Moonshot 等),选择后自动填入地址与配置类型 |
| Provider | 必填,上游地址 |
| SecretKey | 必填,至少 20 个字符,加密存储 |
| 配置类型 | 标准配置、Azure OpenAI 配置(模型到 deployment 的映射、API Version 映射)、Google Vertex AI 配置(Base URL、Project ID、Client Email、Private Key) |
| 休眠策略 | 免休眠:命中自动休眠条件时也不移出轮询池 |
添加成功后,若后端自动调整了 Level 映射,通知中会显示新增与清理的映射。
Provider 列表:按 Level 分组展示,列表每 30 秒自动刷新;开启粘性调度的 Level 带“粘性”标签。每个 Key 显示状态(启用、禁用、休眠中、自动休眠中、长休)与以下操作:
| 操作 | 说明 |
|---|---|
| 长休 / 唤醒 | 手动休眠 32 小时,或立即唤醒 |
| 克隆 | 以相同 Level、Provider、SecretKey 与配置复制一个 Key,用于增加该 Key 在轮询中的权重 |
| 编辑 | 修改 Name、Level、Provider、SecretKey(留空不变)、配置、启用状态与休眠策略 |
| 删除 | 删除 Key,不可撤销 |
系统配置
系统配置对应《租户配置 API》。保存时只提交有变化的字段,被清空的字段恢复默认值;保存前会检查 Level 映射冲突、分组切换的自引用与循环、模型故障替换的重复与循环。
模型定价
覆盖本租户的模型价格(PRICING),保存后立即生效:
- 单模型快速改价:选择计费类型与模型 ID,编辑该模型的价格 JSON(必须包含
Rates),可读取当前覆盖、查看生效价、填入模板、保存或删除覆盖。 - 完整定价 JSON:一次编辑全部覆盖,提供模板一键填充。
- 前端校验:总大小 ≤ 128 KB,条目 ≤ 1024 个,数值为有限非负数。
基础配置
| 字段 | 配置键 |
|---|---|
| 系统通知邮箱 | XAI_MAIL |
| 允许的资源路径 | RESOURCES(当前版本仅保存与展示;限制实际访问请设置账号的 Resources) |
| 系统模型限额(JSON) | MODEL_LIMITS,提供模板;* 清空,-model 删除 |
邮件配置
SMTP 服务器、SMTP 端口、认证账号、发件人、邮箱密码,对应 EMAIL_SMTP、EMAIL_PORT、EMAIL_AUTH、EMAIL_SENDER、EMAIL_PASS。未配置时使用部署的默认邮件服务。
映射配置
| 界面名称 | 配置键 | 格式 |
|---|---|---|
| 系统模型映射 | MODEL_MAPPER | 原模型=目标模型 |
| 系统模型分组 | LEVEL_MAPPER | 模型=分组号 |
| 模型分组切换 | SWITCH_OVER | 主分组=备分组 |
| 粘性调度分组 | STICKY_LEVELS | 分组号列表;全局粘性调度开启时隐藏 |
| 模型映射切换 | MODEL_FAILOVER | 主模型=备模型 |
注册安全(仅 root)
邮箱域名白名单与黑名单(SIGNUP_ALLOW_DOMAINS、SIGNUP_DENY_DOMAINS),支持换行、逗号或空格分隔,支持 *.example.com。
支付与商品(仅 root,需配置 XPAY_API)
配置了合法的支付网关地址(含 /t/<tenant>)后,root 可在此管理:商品目录范围、订阅套餐、按量卡、扩展卡、服务与数字商品,以及数字商品订单交付、发票受理、团购发车与原路退款。这些操作直接调用支付网关接口。
收入统计(仅 root,需配置 XPAY_API)
按昨日、7 天、本月、上月、90 天、1 年、3 年或自定义区间查看:区间收款、退款与净收入、订单数与客单价,收入趋势、商品类型与支付方式分布,以及今日订单、支付排行与每日明细。
广播通知
- 字段:标题(可选)、目标 ID(可选)、内容(必填)。
- 填写目标 ID 时发送给该账号;留空时发送给当前账号的直接子账号(
POST /x-news/{DNA})。通知有效期 32 天。 - “最近通知”只记录本浏览器最近发送的 3 条。删除已发送的通知请使用
DELETE /x-news/...,见《账号管理 API》。
操作日志
显示当前账号最近的管理操作(时间、行为、目标、详情、IP,悬停可见 User-Agent),首次打开时加载。对应 GET /dashboard/logs。
部署配置
控制台通过容器环境变量渲染的 config.js 获取运行参数,见《配置参考》。
| 变量 | 对本控制台的影响 |
|---|---|
XAI_API | API 地址 |
XAI_MANAGE | 账户管理控制台入口地址 |
XPAY_API | 启用收入统计与商品、订单、发票、团购、退款管理 |
LICENSE_ID | 授权徽标 |
BRAND_NAME | 品牌名 |
XAI_REFERRAL_REWARD_RATE | 注册推荐码与奖励比例显示 |