账户管理控制台
账户管理控制台(Manage)面向所有账号:普通账号查看用量、管理资料与 Key;具备管理者权限的账号还可以创建和管理子账号。所有操作直接调用 XSI API。
登录与注册
- 使用 XSI API Key 登录(
sk-Xvs开头,51 位),通过GET /dashboard/status验证。忘记 Key 时可在注册邮箱中搜索sk。 - Key 保存在浏览器本地,重新打开页面会自动登录;任何请求返回
401时自动退出。 - 登录页提供邮箱注册(
POST /x-sign)与推荐码;URL 中的?ref=会自动填入推荐码。 EN/中切换语言;英文界面位于/en/。登录页底部展示XSI by XABC Labs署名。- 导航栏的广播位与页面右侧的推广卡片是 XSI 的保留展示位,免费使用时须原样保留,见 LICENSE 第 5 条。
页面一览
| 页面 | 可见条件 |
|---|---|
| 用量统计 | 所有账号 |
| 我的账户 | 所有账号 |
| 账户充值 | 部署配置了 XPAY_API |
| 配置说明 | 所有账号 |
| AI API | 所有账号 |
| 洞察子账户、子账户列表、查看子账户、创建子账户、动账子账户、更新子账户、删除子账户、操作日志 | 管理者 |
没有管理者权限时,子账号相关页面隐藏并显示提示。档位、分组、角色、因子、额度类型等字段只对租户所有者显示。
用量统计
- 三种模式:今日实时、指定日期、时间范围(最长 3 年)。数据来自
GET /dashboard/bill。 - 今日额度状态(Role 2、3 账号可见):RPD、TPD 与日额度的进度条,各额度卡的使用进度与策略标签。数据来自
GET /dashboard/live。 - 统计卡片:总花费、总请求、网络搜索、图片处理、总 Tokens、输入与输出 Tokens、缓存读写。
- 模型费用分布与调用分布图,模型使用明细表(可按花费、请求数、搜索数、图片数或名称排序)。
- 时间范围模式下另有每日趋势图与日明细。
查询跨度超过 30 天时会收取一次管理调用费(默认 ¥0.012)。
我的账户
- 账户资料:昵称、邮箱、账单邮箱(最多 3 个);开启推荐功能时显示“我的推荐码”与推荐链接;开启支付时可填写发票资料(普票或专票)。保存时只提交修改过的字段(
PUT /x-users?id=<本人>)。 - API Key 安全:显示当前 Key 的预览,可一键重新生成(
POST /x-self),旧 Key 立即失效,10 分钟内不能重复操作。root 账号请通过 API 使用ROTATE-ROOT确认短语轮换。 - 批量余额查询:输入多个 Key(换行或逗号分隔),分别查询邮箱、额度卡、已用与余额、今日与本月用量、请求数与限速。查询历史保存在本地。
账户充值
部署配置了支付网关后可用:
- 输入金额(最低 50 元)或选择快捷金额,使用微信扫码支付;1 元 = 1 元额度,有效期 1 年。
- 套餐列表:显示当前套餐、Factor、价格、到账额度与天数;切换到不同 Level 的套餐会清空当前余额,购买前会提示。
- 当前订单状态自动轮询;充值记录中可查看订单、团购状态,并为已支付订单申请开票与下载发票。
- 套餐跟随上级账号的子账号不显示套餐。
配置说明
Codex CLI / App、Claude Code、OpenCode 的接入配置,提供 Linux / macOS 一键配置脚本及 Windows CMD、PowerShell 片段。示例中的 Key 自动替换为当前登录的 Key。
AI API
系统工作流程、SDK 示例与 cURL 示例,Base URL 自动填入当前部署地址。
子账号管理
以下页面需要管理者权限,对应《账号管理 API》。
子账户列表
- 分页展示全部后代(
GET /x-dna)。搜索框支持:数字 ID、邮箱、DNA 前缀(以.开头),其他文本做模糊匹配;点击卡片上的 DNA 可筛选该分支。 - 每张卡片显示直属或后代、启用状态、邮箱与昵称、能否继续创建子账号(及原因)、余额与额度卡,所有者另可见角色、档位、分组、因子与创建时间。
- 快速调额(
+/-):输入金额与有效天数(最长 365 天),所有者可选择额度类型。 - 批量调整额度:对当前筛选结果(无筛选时为全部后代)批量发放或扣回,先预览再执行,预览列出每个账号的处理结果(
POST /x-users/batch-credit)。 - 编辑抽屉:基础信息、限额(月额度、日额度、子账号数)、六维限速、IP / 模型 / 资源白名单、模型映射、模型限额、账单邮箱与二维码;所有者另可修改档位、分组、角色、因子、允许的分组与模型分组映射。模型与资源白名单可选择应用范围(仅当前账号、当前账号及所有后代、仅所有后代),递归应用前会先预览影响。
- 删除:确认后删除。
洞察子账户
按日期区间(最长 3 年)汇总全部后代的用量(GET /x-bill):统计卡片、模型费用与调用分布、成本趋势与每日趋势、子账户消耗概览(含成本与请求占比)、模型分布与每日明细。此页查询不收取管理调用费。
查看子账户
按 ID、账号名、邮箱或 DNA 查询后代账号,结果以 JSON 显示,并附 cURL、Python 与 JavaScript 示例。
创建子账户
| 字段 | 说明 |
|---|---|
| 邮箱 | 必填,全局唯一,用于接收 API Key |
| 昵称 | 可选,默认使用邮箱前缀 |
| 初始额度 | 必填;低于系统最低额度(USER_MIN_BALANCE)时自动提高到最低额度 |
| 额度类型 | 仅所有者:扩展卡(按量)或订阅卡 |
创建成功后显示子账号的 ID、标识与 API Key;Key 同时发送到子账号邮箱。其余属性继承当前账号,可在“更新子账户”或编辑抽屉中调整。
动账子账户
输入子账号的 ID、账号名或邮箱,以及金额(正数充值、负数扣回)与可选的有效天数(最长 365 天)。所有者可选择额度类型,未填有效天数时默认 31 天;其他管理者未填时沿用来源额度的有效期。
更新子账户
按 ID、账号名或邮箱定位,修改邮箱、昵称、费率、状态、月额度、日额度、子账号数、六维限速、模型限额、IP / 模型 / 资源白名单、模型映射、账单邮箱与二维码;所有者另可修改档位、分组、角色、因子、允许的分组与模型分组映射。留空的字段不会修改;但普通管理者的任何更新都会把目标的 Level、角色与映射对齐到自己,见《账号管理 API》。
删除子账户
按 ID、账号名或邮箱删除,操作不可撤销,子账号的 Key 立即失效。剩余额度按规则退回,并收取一次管理调用费。
操作日志
显示当前账号最近的管理操作:时间、行为、目标、详情(JSON)与 IP。
其他
- 通知横幅:显示系统公告、个人通知与分组通知,可选择“今日不再显示”。
- 会员徽章:配置支付网关后,在“我的账户”与“账户充值”中显示会员等级,可分享或下载分享卡。
- 授权徽标:显示部署的商业授权状态(
LICENSE_ID)。 - 客服二维码:账号或部署配置了支持二维码时显示。
部署配置
| 变量 | 对本控制台的影响 |
|---|---|
XAI_API | API 地址 |
XAI_ADMIN | 所有者可见的配置管理控制台入口 |
XPAY_API | 启用账户充值、发票资料与会员徽章 |
SUPPORT_QR_URL | 客服二维码 |
XAI_HIDE_MODEL_PRICING | 隐藏登录页的“模型与价格”链接 |
XAI_REFERRAL_REWARD_RATE | 推荐功能与奖励比例显示 |
LICENSE_ID、BRAND_NAME | 授权徽标、品牌名 |