Manage 控制台

XAI Manage 是面向最终使用者或被授权的管理员的图形化控制台，提供账户状态、额度、用量、账单、日志与新闻查看，以及常用自助能力（如密钥轮换、子账户管理）。

—

功能概览

XAI Manage 控制台包含以下核心功能模块：

1. 用量统计（Dashboard） - 查看今日实时用量、指定日期和时间范围的用量分析
2. 账户查询 - 批量查询子账户信息
3. AI API 文档 - 查看支持的 AI 服务提供商和 SDK 示例
4. 创建子账户 - 在您的账户下创建新的子账户
5. 账户充值 - 为子账户充值或扣款
6. 查看子账户 - 查看所有子账户列表
7. 更新子账户 - 修改子账户的配置和限制
8. 删除子账户 - 删除子账户并退还余额
9. 操作日志 - 查看账户操作记录
10. 系统配置 - 跳转到 Admin 控制台（仅主账户）

—

访问控制

• 所有用户可访问：任何持有有效 API Key 的用户都可以登录 Manage 控制台
• 本地存储密钥：API Key 仅保存在浏览器本地（localStorage），不会上传到服务器
• 会话缓存：用户信息缓存在 sessionStorage 中（24 小时），关闭标签页后需要重新获取
• 新闻缓存：新闻数据本地缓存 1 小时，支持"今日不再显示"功能

—

常见任务导航

• 查看今日/历史用量 → “用量统计” → GET /dashboard/bill（date/start-end/days）
• 批量查询子账户 → “账户查询” → GET /x-users/{identifier} / GET /x-users / GET /x-dna
• 创建子账户 → “创建子账户” → POST /x-users
• 充值/退款 → “账户充值” → PUT /x-users/{identifier}（CreditGranted/Days）
• 限制访问范围 → “更新子账户” → PUT /x-users/{identifier}（AllowModels/AllowIPs/Resources）
• 设置模型限速 → “更新子账户” → PUT /x-users/{identifier}（ModelLimits）
• 查看操作日志 → “操作日志” → GET /dashboard/logs

功能-端点-权限 总览

术语对齐：Level、Model Mapper、Level Mapper、Resources（白名单）、Model Limits（详见《术语表》）。

功能详解

1. 用量统计标签页

实时查看和分析账户用量数据，支持多种时间维度和指标切换。

功能包括：

• 今日实时用量 - 显示今日的请求数、Token 数和成本
• 指定日期查询 - 选择特定日期查看当日用量
• 时间范围查询 - 选择起止日期查看区间用量
• 指标切换 - 在成本、请求数、Token 数之间切换
• 图表展示 - 用量趋势图（如果有多天数据）
• 模型用量明细 - 按模型查看详细用量分布

操作步骤：

1. 默认显示今日实时用量
2. 选择"指定日期"并选择日期查看单日用量
3. 选择"时间范围"并设置起止日期查看区间用量
4. 使用指标切换按钮在不同维度间切换

对应后端端点：

• GET /dashboard/bill - 获取用量数据
• 查询参数：date（单日）、start/end（范围）、days（过去N天）

2. 账户查询标签页

批量查询子账户的详细信息。

功能包括：

• 批量查询 - 输入多个账户标识符，用逗号或换行分隔
• 支持多种标识符 - ID、Name、Email、DNA 路径等
• 详细信息展示 - 显示账户余额、限制、用量等完整信息
• 结果导出 - 可复制查询结果

标识符类型：

• 用户 ID：42
• 用户名：prod-account
• 邮箱：[email protected]
• DNA 路径：.1.42.
• Level 筛选：L2（所有 2 级用户）

对应后端端点：

• GET /x-users/{identifier} - 查询单个或批量用户

3. AI API 文档标签页

与 Admin 控制台相同，展示支持的 AI 服务提供商和 SDK 示例代码。

功能包括：

• 模型列表链接
• 支持的 AI 服务提供商展示
• OpenAI 和 Anthropic SDK 示例代码
• 一键复制功能

4. 创建子账户标签页

在您的账户下创建新的子账户。

功能包括：

• 完整的创建表单 - 包含所有必填和可选字段
• 实时验证 - 字段格式和值的实时验证
• 灵活配置 - 支持设置限额、速率限制、白名单等

表单字段：

基本信息（必填）：

• Name - 账户名（4-63 字符，至少 1 个字母）
• Email - 邮箱地址
• CreditGranted - 初始充值金额（最小 2 美元）

可选配置：

• Alias - 显示名称
• BillingEmail - 账单邮箱
• Rates - 费率乘数（必须 ≥ 父账户费率）
• Days - 余额有效期天数

限额设置：

• HardLimit - 每月硬性限额
• SoftLimit - 每月软性限额（达到后邮件提醒）
• AutoQuota - 自动配额

速率限制：

• RPM/RPH/RPD - 每分钟/小时/天的请求数限制
• TPM/TPH/TPD - 每分钟/小时/天的 Token 数限制

访问控制：

• AllowIPs - IP 白名单（逗号分隔）
• AllowModels - 模型白名单（支持通配符，如 gpt-4*）
  • Resources - 资源白名单

模型限速：

• 为特定模型设置独立的速率限制（JSON 格式）

对应后端端点：

• POST /x-users - 创建子账户

5. 账户充值标签页

为子账户充值或扣款。

功能包括：

• 账户选择 - 输入用户 ID、Name 或 Email
• 充值/扣款 - 正数为充值，负数为扣款
• 自定义有效期 - 设置余额有效期天数
• 批量操作 - 支持同时为多个账户操作

操作说明：

1. 输入目标账户标识符
2. 输入金额：
   • 正数（如 100）表示充值 100 美元
   • 负数（如 -50）表示扣款 50 美元
3. 可选：设置有效期天数（默认 180 天）
4. 提交操作

对应后端端点：

• PUT /x-users/{identifier} - 更新用户（包含充值/扣款）
• 请求体：{"CreditGranted": 100, "Days": 30}

6. 查看子账户标签页

查看所有直属子账户的列表和详细信息。

功能包括：

• 账户列表 - 显示所有子账户
• 关键信息 - ID、Name、Email、Balance、Status
• 筛选和搜索 - 按条件筛选账户
• 快速操作 - 点击账户查看详情或执行操作

对应后端端点：

• GET /x-users - 获取所有直属子账户
• GET /x-dna - 获取所有后代账户

7. 更新子账户标签页

修改现有子账户的配置和限制。

功能包括：

• 完整的更新表单 - 与创建表单类似，但支持部分更新
• 状态管理 - 启用/禁用账户
• 配置修改 - 修改限额、速率、白名单等
• 模型限速 - 更新模型级别的速率限制

可更新字段：

所有创建时的可选字段都可以更新，另外还包括：

• Status - 启用/禁用账户（true/false）
• CreditGranted - 充值/扣款
• Days - 余额有效期
• 限额、速率、白名单的增量修改

特殊操作：

• 重置白名单：AllowModels: "*"
• 从白名单移除：AllowModels: "-gpt-3.5-turbo"

对应后端端点：

• PUT /x-users/{identifier} - 更新用户

8. 删除子账户标签页

删除子账户并退还其剩余余额到父账户。

功能包括：

• 账户选择 - 输入要删除的账户标识符
• 余额退还 - 自动退还剩余余额到父账户
• 交易费用 - 扣除 0.2 美元手续费
• 确认机制 - 防止误删除

注意事项：

• 剩余余额会自动退还给父账户
• 扣除 0.2 美元的交易手续费
• 退还的余额默认有效期为 180 天
• 删除后不可恢复

对应后端端点：

• DELETE /x-users/{identifier} - 删除用户

9. 操作日志标签页

查看当前账户的操作日志。

功能包括：

• 日志列表 - 显示时间、操作、目标、详情、IP
• 分页浏览 - 支持分页查看历史日志
• 筛选功能 - 按操作类型、状态等筛选

对应后端端点：

• GET /dashboard/logs - 获取操作日志

10. 系统配置入口

主账户可以看到"配置管理"链接，点击跳转到 Admin 控制台。

—

新闻横幅功能

Manage 控制台顶部会显示系统新闻和用户通知。

功能包括：

• 优先级展示 - 系统新闻 > 用户新闻 > DNA 新闻
• 今日不再显示 - 关闭后今日不再显示该新闻
• 自动轮播 - 多条新闻自动切换
• 本地缓存 - 新闻缓存 1 小时，减少请求

对应后端端点：

• GET /dashboard/news - 获取新闻列表

—

使用场景

场景 1：查看今日用量

1. 登录后默认显示"用量统计"标签页
2. 页面自动展示今日实时用量：
   • 今日请求数
   • 今日 Token 数
   • 今日成本
3. 查看详细的模型用量分布

场景 2：创建开发环境子账户

1. 进入"创建子账户"标签页
2. 填写基本信息：
   • Name: dev-env-001
   • Email: [email protected]
   • CreditGranted: 10（充值 10 美元）
3. 设置限制：
   • HardLimit: 50（每月最多花费 50 美元）
   • SoftLimit: 40（达到 40 美元时邮件提醒）
   • RPM: 30（每分钟最多 30 次请求）
4. 设置白名单：
   • AllowModels: gpt-4o-mini claude-3-haiku*（只允许使用这些模型）
5. 提交创建
6. 系统返回新账户的 API Key

场景 3：为子账户充值

1. 进入"账户充值"标签页
2. 输入子账户名：dev-env-001
3. 输入充值金额：50
4. 设置有效期：30 天
5. 提交操作
6. 系统确认充值成功

场景 4：更新子账户限制

1. 进入"更新子账户"标签页
2. 输入账户标识符：dev-env-001
3. 修改配置：
   • RPM: 60（提高速率限制）
   • AllowModels: gpt-4* claude-*（扩大模型白名单）
4. 提交更新
5. 系统确认更新成功

场景 5：分析用量趋势

1. 进入"用量统计"标签页
2. 选择"时间范围"
3. 设置起止日期：2025-01-01 至 2025-01-31
4. 切换指标查看：
   • 成本趋势
   • 请求数趋势
   • Token 使用趋势
5. 查看各模型的用量分布

—

最佳实践

账户管理

1. 分级管理 - 为不同环境（开发/测试/生产）创建独立账户
2. 合理限额 - 设置 SoftLimit 和 HardLimit 避免意外超支
3. 模型白名单 - 限制子账户只能使用特定模型
4. 定期审计 - 定期查看子账户列表和用量

充值管理

1. 按需充值 - 不要一次充值过多
2. 设置有效期 - 为测试账户设置较短的有效期
3. 保留余额 - 删除账户前先扣款以回收余额

用量监控

1. 每日检查 - 查看今日用量避免异常
2. 趋势分析 - 定期分析用量趋势优化成本
3. 模型优化 - 根据用量数据选择合适的模型

—

常见问题

Q: 为什么我看不到"系统配置"入口？

A: 只有主账户（Owner）才能看到"配置管理"入口。子账户只能管理自己的子账户。

Q: 创建子账户时最小充值金额是多少？

A: 最小充值金额是 2 美元（CreditGranted ≥ 2）。

Q: 如何限制子账户只能使用特定模型？

A: 在创建或更新子账户时，设置 AllowModels 字段。支持通配符，如 gpt-4* claude-3-haiku*。

Q: 子账户的费率可以低于父账户吗？

A: 不可以。子账户的 Rates 必须大于或等于父账户的费率。

Q: 删除子账户后余额如何处理？

A: 剩余余额会自动退还到父账户，扣除 0.2 美元手续费，有效期 180 天。

Q: 为什么查询用量时提示收费？

A: 查询跨度超过 30 天会收取 0.01 美元，超过 365 天会收取 0.05 美元并截断至一年。

Q: 如何批量查询多个子账户？

A: 在"账户查询"标签页输入多个标识符，用逗号或换行分隔，如：

dev-env-001
prod-account
[email protected]
42

—

相关文档

• 用户管理 API - 子账户管理的底层 API
• 仪表盘 API - 用量和状态查询的底层 API
• Admin 控制台 - 配置管理控制台
• 快速开始 - 基础入门指南