Skip to content

phsl / docs

Go to a project
Commit 747f6de2 by ccran
Options

更新管理员使用手册以适配新版控制台与配置流程

parent c92539d5
Showing with 126 additions and 66 deletions
普惠算力平台-管理员使用手册.md
# 普惠算力平台-管理员使用手册 # 普惠算力平台-管理员使用手册
# 普惠算力平台-管理员使用手册 # 普惠算力平台-管理员使用手册
文档日期 ： 2026/06/30 文档日期：2026/09/07
普惠算力主站: [phslgld.hnluchuan.com](https://phslgld.hnluchuan.com/) 普惠算力主站: [phslgld.hnluchuan.com](https://phslgld.hnluchuan.com/)
...@@ -12,141 +12,202 @@ ...@@ -12,141 +12,202 @@
## 一、普惠算力NewAPI中转站 ## 一、普惠算力NewAPI中转站
### 1. 系统初始化 ### 1. 系统初始化与控制台入口
按系统提示走完流程,创建管理员账号,**使用模式选择"对外运营模式"**。 首次部署时按初始化向导创建管理员账号，使用模式选择「对外运营模式」。已初始化的站点直接使用管理员账号登录，无需重复初始化。
![系统初始化](系统初始化.png) 登录后进入「概览」，可查看设置进度、余额、用量和请求情况，也可通过快捷入口进入渠道、使用日志和定价页面。左侧导航收起时，点击左上角侧边栏按钮展开。
![新版控制台概览](image/newapi-20260907/控制台概览.png)
点击「显示设置引导」可展开 API 密钥、添加额度和发送请求的引导。当前站点已完成初始化，下图为新版控制台中的设置引导。
![新版设置引导](image/newapi-20260907/设置引导.png)
--- ---
### 2. 添加渠道 ### 2. 配置渠道和模型映射
渠道是平台对接 AI 服务商的核心配置单元，每条渠道对应一个服务商的 API Key。使用管理员账号登录后，在左侧导航中点击「渠道」。
> 模型配置请参考 [token模型需求表-0831.xlsx](token模型需求表-0831.xlsx)。后续的渠道模型、模型映射、模型信息和模型定价都以这份 Excel 为准，各环节的「模型名称」必须保持一致。
渠道是平台对接 AI 服务商的核心配置单元,每条渠道对应一个服务商的 API Key。使用管理员账号登录后,左侧导航点击「渠道」。渠道列表展示所有已配置的 AI 服务商渠道,包含名称、类型、状态(绿色 = 正常 / 红色 = 禁用)、响应时间、已用配额等信息。 ![渠道列表](image/newapi-20260907/渠道列表.png)
![添加渠道](添加渠道.png) **渠道基本信息配置：**
**添加渠道流程:** 1. 在渠道列表页点击右上角「创建渠道」；已有渠道可通过「打开菜单 → 编辑」进入配置页面。
2. 选择服务商类型（天翼云选择 OpenAI），填写渠道名称、API 地址和 API 密钥。天翼云 API 地址为 `https://ai.ctaigw.cn`，不要附加 `/v1` 或尾部斜杠。
3. 向下滚动至「模型与分组」，按以下两步配置渠道模型和映射后再保存。
1. 在渠道列表页点击右上角「添加渠道」按钮,弹出配置弹窗 ![创建渠道](image/newapi-20260907/创建渠道.png)
2. 在弹窗中选择服务商类型(天翼云的是 OpenAI)
3. 填写渠道名称和 API Key
4. 在模型列表中勾选该渠道支持的模型,**推荐点击「获取模型列表」按钮自动拉取**
![获取模型列表](获取模型列表.png) **第一步：批量添加渠道模型**
5. 点击「提交」按钮完成渠道添加,新渠道出现在列表中 1. 打开 Excel 模板，复制「模型名称」列的所有数据，不要复制表头。
2. 在「批量添加模型」文本框中粘贴模型名称。系统支持逗号、空格、分号或换行分隔。
3. 点击「新增模型」，确认模型已加入渠道。
![渠道创建成功](渠道创建成功.png) ![渠道批量添加模型](image/newapi-20260907/渠道批量添加模型.png)
6. 渠道添加，支持批量增加模型。 已添加的模型会显示在上方列表中，核对名称和数量是否与 Excel 一致。
![1782729028239](image/普惠算力平台-管理员使用手册/1782729028239.png) ![渠道模型列表](image/newapi-20260907/渠道模型列表.png)
**第二步：导入模型映射**
1. 在同一页面的「模型映射」区域点击「从 Excel 导入」，选择填写完成的 Excel 文件。
2. 检查映射结果：「原始模型」对应 Excel 中的「模型名称」，「替换模型」对应「映射模型」，即上游服务商的实际模型 ID。
3. 确认每个渠道模型都已映射到正确的上游模型 ID，并配置可访问渠道的分组。新建渠道点击「保存更改」，编辑已有渠道点击「更新渠道」。
![渠道导入模型映射](image/newapi-20260907/渠道模型映射.png)
--- ---
### 3. 添加模型 ### 3. 导入并配置模型信息
使用管理员账号登录后，在左侧导航点击「模型」，进入「元信息」页面。
使用管理员账号登录后,左侧导航点击「模型管理」。 ![模型管理](image/newapi-20260907/模型管理.png)
1. 在页面中点击「未配置模型」按钮,可看到渠道支持但**未被配置**的模型 **第三步：导入模型信息**
![未配置模型](未配置模型.png) 1. 点击「添加模型」旁的下拉菜单，选择「导入模型」，再选择同一份 `.xlsx` 文件。文件大小不能超过 10 MB。
2. 导入文件的第一行必须是表头。按模板填写模型名称、图标、匹配类型、参与官方同步、描述、供应商、标签和端点（路由）等信息。「映射模型」用于上一节的渠道映射配置。
3. 如需更新已存在的模型，勾选「覆盖已存在的模型」；首次导入时保持不勾选。
4. 点击「导入」，完成后在模型列表中检查名称、图标、标签、供应商和端点配置。
2. 点击「配置」,模型名称已自动填充,名称匹配类型选默认的「精确名称匹配」,可填图标和描述用于普惠模型列表展示。点击「保存」完成配置。 ![批量导入模型信息](image/newapi-20260907/导入模型信息.png)
![添加模型](添加模型.png) 导入窗口使用英文字段名说明要求，模型名称为必填列。参考模板的字段对应关系如下：
3.在创建模型或编辑模型时可以配置标签，一个模型可以设置多个标签，标签可用于普惠模型列表筛选 | Excel 列名 | 界面字段名 | 用途 |
| --- | --- | --- |
| 模型名称 | `model_name` | 平台模型标识，与渠道中的名称一致 |
| 图标 | `icon` | 模型图标键名 |
| 匹配类型 | `name_rule` | 名称匹配规则 |
| 参与官方同步 | `sync_official` | 是否参与官方同步 |
| 描述 | `description` | 模型说明 |
| 供应商 | `vendor_name` | 模型供应商 |
| 标签 | `tags` | 模型分类标签 |
| 端点 | `endpoints` | API 端点类型、路径和请求方法 |
![配置标签](配置标签.png) 创建或编辑模型时也可以单独配置标签。一个模型可以设置多个标签，标签可用于普惠模型列表筛选。
![标签筛选](标签筛选.png) ![配置模型信息与标签](image/newapi-20260907/模型信息与标签.png)
4. 新增模型支持批量Excel导入。 在模型编辑窗口向下滚动，可设置「匹配规则」与「端点」。端点配置包含端点类型，以及 `path`、`method` 等信息，完成修改后点击「更新模型」。
![1782729154314](image/普惠算力平台-管理员使用手册/1782729154314.png) ![配置模型端点路由](image/newapi-20260907/模型端点路由.png)
![1782729241561](image/普惠算力平台-管理员使用手册/1782729241561.png) ---
### 4. 调整额度单位(汇率) ### 4. 调整额度单位(汇率)
使用管理员账号登录后,左侧导航点击「系统设置」,第一个 tab「**运营设置**」下的「通用设置」。 使用管理员账号登录后，进入「系统设置 → 计费与支付 → 货币与展示」。
将「显示模式」设为「元」，并按平台的计价口径设置「人民币兑美元汇率」。本平台当前采用数值 1，即 1:1 的展示口径，修改后点击「保存更改」。
> ⚠️ New API 系统默认所有额度将以美元($)显示,使用过程中可以无视。**但如果需要以人民币显示**,需将汇率设置为 1:1,因为填写模型价格时单位依旧是美元,并不会变为人民币。点击「保存通用设置」生效。 > 模型定价编辑器仍以美元或每百万 Token 美元价格标注。货币展示设置与支付网关中的「价格（本地货币/美元）」是不同配置，修改前需核对平台实际计价口径。
![运营设置](运营设置.png) ![货币与展示](image/newapi-20260907/货币与展示.png)
--- ---
### 5. 开启充值功能(为了开通兑换码功能) ### 5. 开启充值功能(为了开通兑换码功能)
使用管理员账号登录后,点击「系统设置」的「**支付设置**」tab 选项。填写确认合规声明。 使用管理员账号登录后，进入「系统设置 → 计费与支付 → 支付网关」。首次配置时按页面要求确认合规声明。已确认的站点会显示「合规已确认」及确认记录。
在「常规」页配置支付通用参数，按实际接入方式配置对应网关，完成后点击「保存所有设置」。
![确认合规声明](确认合规声明.png) ![支付网关与合规确认](image/newapi-20260907/支付网关与合规.png)
--- ---
### 6. 设置模型价格 ### 6. 设置模型价格
使用管理员账号登录后,点击「系统设置」的「**分组与模型定价设置**」tab 选项。 使用管理员账号登录后，进入「系统设置」，在左侧「计费与支付」下点击「模型定价」。
![分组与模型定价设置](分组与模型定价设置.png) **第四步：导入模型定价**
**操作步骤:** 1. 在「模型价格」页点击「Excel 导入」，选择同一份 Excel 文件（`.xlsx`，不超过 10 MB）。
2. 第一行必须是表头，按「模型名称」匹配模型。按次计费填写「固定价格」；否则必须填写「输入价格」，并按需要填写输出价格和缓存价格。
3. 核对文件后点击导入窗口中的「导入」。导入会覆盖匹配模型的计费方式：按量计费会清除固定价格，按次计费会清除倍率设置。
4. 返回列表检查模型名称、模式和价格摘要。需要查看或修改倍率时可点击「切换到 JSON」，手动修改后点击「保存模型价格」。
1. 列表中已有默认的模型定价。可点击「手动编辑」,**清空数据**。在最下方点击「保存模型倍率设置」按钮保存。 ![模型定价列表](image/newapi-20260907/模型定价列表.png)
![手动编辑,清空数据](手动编辑，清空数据.png) ![Excel 导入模型定价](image/newapi-20260907/导入模型定价.png)
2. 点击「**未设置价格模型**」,可看到还未设置价格的模型列表。 | Excel 列名 | 导入窗口字段名 |
| --- | --- |
| 模型名称 | `model_name` |
| 固定价格 | `fixed_price` |
| 输入价格 | `input_price` |
| 输出价格 | `completion_price` |
| 缓存价格（元/百万token） | `cache_price` |
![未设置价格模型](未设置价格模型.png) 导入后还需检查缓存价格等可选项是否实际生效。JSON 页面中的「提示缓存倍率」用于查看缓存读取计费配置。
3. **按量计费**:设置输入价格、补全价格(输出价格) ![模型定价 JSON 配置](image/newapi-20260907/模型定价JSON.png)
![设置模型按量收费](设置模型按量收费.png) **单个模型补充配置：**
4. **按次计费**:输入固定价格 在模型定价列表中搜索目标模型，点击对应行的「编辑」；新增定价条目使用「添加模型」。
![设置模型按次收费](设置模型按次收费.png) **按量计费：** 选择「按 Token」，设置输入价格，开启「补全价格」后填写输出价格；缓存读取、缓存写入、图像和音频价格按模型能力配置。价格单位为每 100 万 Token。
5. **阶梯计费**:根据单次使用量分阶段计费，完整的阶梯收费需要点击模型后在右侧边栏查看。 ![按量计费](image/newapi-20260907/按量计费.png)
![设置模型阶梯计费](设置模型阶梯计费.png) **按次计费：** 选择「按次」，填写每次请求的固定价格。
![右侧边栏](右侧边栏.png) ![按次计费](image/newapi-20260907/按次计费.png)
6. 点击「应用更改」按钮保存。 **阶梯计费：** 选择「表达式」，在「可视化编辑器」中配置档位条件及输入、输出和缓存价格。最后一个无条件阶梯作为兜底。
7. 模型定价支持批量Excel定价。
![1782729220843](image/普惠算力平台-管理员使用手册/1782729220843.png) ![阶梯计费](image/newapi-20260907/阶梯计费.png)
![1782729241561](image/普惠算力平台-管理员使用手册/1782729241561.png) 向下滚动可查看「请求规则计费」和「Token 估算器」，检查条件、倍率及估算费用。完成编辑后点击「保存模型价格」。
![阶梯请求规则与估算器](image/newapi-20260907/阶梯请求规则.png)
--- ---
### 7. 获取管理员系统访问令牌 ### 7. 获取管理员系统访问令牌
使用管理员账号登录后,左侧导航点击「个人设置」,页面中点击「**安全设置**」,点击「**生成令牌**」。 使用管理员账号登录后，进入「个人资料」，在「安全」区域找到「访问令牌」。
> 当前版本点击「访问令牌」入口可能直接生成或重新生成令牌，并复制到剪贴板。操作前确认使用该令牌的后端配置；重新生成后应同步更新接入系统中的 `admin-token`。
![获取管理员系统访问令牌](获取管理员系统访问令牌.png) ![管理员系统访问令牌入口](image/newapi-20260907/管理员访问令牌入口.png)
在普惠后端项目中配置 New API 的地址、admin-token、admin-user-id(**admin-user-id 为 1**)。 在普惠后端项目中配置以下信息。系统访问令牌用于后台管理接口，应保存在后端配置中。
![配置 newapi 信息](配置newapi信息.png) | 配置项 | 说明 |
| --- | --- |
| New API 地址 | `http://phslgld.hnluchuan.com:3000` |
| `admin-token` | 管理员系统访问令牌 |
| `admin-user-id` | 当前管理员的用户 ID，本平台超级管理员为 `1` |
### 8. 使用日志 ### 8. 使用日志
1. 左侧导航点击「**使用日志**」。可以看到所有用户的使用、消费、充值、管理等记录，也可以看到用户的操作记录，并且可以基于时间日期等参数进行筛选。 左侧导航点击「使用日志」，进入「通用日志」。选择时间范围、模型、分组和日志类型，点击「展开」可使用用户名、令牌名称、渠道 ID 等更多筛选条件，再点击「搜索」。
![使用日志](使用日志.png) 列表展示调用耗时、Token 数、费用，以及管理、登录等记录。点击详情列中的内容可查看对应记录的详细信息。
![使用日志](image/newapi-20260907/使用日志.png)
### 9. 查看 / 修改用户余额 ### 9. 查看 / 修改用户余额
在 New API 系统,使用管理员账号登录后,左侧导航点击「**用户管理**」,点击某个用户的「编辑」按钮可看见用户账号的金额,并可直接用管理员账号修改账户余额。 在左侧导航点击「用户」，按用户名查找目标账户，再点击对应行的「编辑」。
![用户列表](image/newapi-20260907/用户列表.png)
在「分组与配额」中查看剩余额度。需要修改时点击「调整额度」，选择「添加」「减少」或「覆盖」，输入金额并核对预览结果，确认后保存用户更改。
![查看用户余额](image/newapi-20260907/用户余额.png)
![用户管理查看用户余额](用户管理查看用户余额.png) ![调整用户额度](image/newapi-20260907/调整用户额度.png)
> ⚠️ **通过管理员增加修改的金额不会展示在普惠面向客户的用户充值列表中。** > ⚠️ **通过管理员增加修改的金额不会展示在普惠面向客户的用户充值列表中。**
...@@ -154,11 +215,11 @@ ...@@ -154,11 +215,11 @@
### 10. 充值底层实现—兑换码 ### 10. 充值底层实现—兑换码
充值 New API 余额是通过**兑换码**实现的。使用管理员账号登录后,左侧导航点击「**兑换码管理**」,可看见充值使用过的兑换码。 普惠主站充值 New API 余额通过**兑换码**实现。使用管理员账号登录后，在左侧导航点击「兑换码」，可按名称、ID 或状态筛选，查看额度、创建时间、过期时间和兑换人。
***必须先开启充值功能。*** ***必须先开启充值功能。***
![兑换码列表](兑换码列表.png) ![兑换码列表](image/newapi-20260907/兑换码列表.png)
## 二、普惠算力主站 ## 二、普惠算力主站
...@@ -196,6 +257,6 @@ ...@@ -196,6 +257,6 @@
1. **未配置价格的模型**:若在 New API 中未设置模型价格,模型价格会**默认显示 75 元，未配置模型价格模型无法调用**。 1. **未配置价格的模型**:若在 New API 中未设置模型价格,模型价格会**默认显示 75 元，未配置模型价格模型无法调用**。
2. **AI token 页**:原 AI token 页需要在普惠后台管理,**算力资源分类管理禁用**。 2. **AI token 页**:原 AI token 页需要在普惠后台管理,**算力资源分类管理禁用**。
3. **数据看板**:New API 数据看板可以看见所有的统计数据。 3. **数据看板**：左侧导航点击「数据看板」，在「模型调用分析」中查看调用数、总额度、Token 数及消耗分布，也可切换「分流」「用户统计」视图。
![数据看板](数据看板.png) ![数据看板](image/newapi-20260907/数据看板.png)
\ No newline at end of file
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or sign in to comment