配置管理控制台

配置管理控制台(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 自动建议
常用 Provider32 个预设(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_APIAPI 地址
XAI_MANAGE账户管理控制台入口地址
XPAY_API启用收入统计与商品、订单、发票、团购、退款管理
LICENSE_ID授权徽标
BRAND_NAME品牌名
XAI_REFERRAL_REWARD_RATE注册推荐码与奖励比例显示

相关文档