ENTERPRISE GUIDE
企业团队接入指南:自建 sub2api,统一管理员工 API 与用量
企业自建 sub2api 接入 RootFlowAI,统一采购模型服务,为员工分配独立账号、API Key、权限和内部预算。
企业可以在 RootFlowAI 统一采购模型服务,再通过自己部署的 sub2api,为员工提供独立账号、API Key、使用权限和内部预算。员工使用企业自己的 API 地址,管理员集中维护上游连接,并按员工查看用量。
本文面向企业内部使用,配置参考 sub2api v0.2.21。更新时间:2026 年 11 月 14 日。不同版本的菜单名称可能略有差异。
部署完成后,员工如何使用
请求经过以下链路:员工的工具 → 企业自建 sub2api → RootFlowAI → 对应模型服务。
图 D01:员工使用个人 Key,企业网关统一接入 RootFlowAI;管理员在企业平台维护权限、预算和用量。查看清晰原图。
例如,企业使用 https://ai.example.com 作为内部 AI 平台:
- 管理员在 RootFlowAI 创建企业专用上游 Key,将它保存在 sub2api 中。
- 管理员在 sub2api 为 Alice、Bob 创建普通员工账号并分配预算。
- 员工登录
https://ai.example.com,创建自己的 API Key,配置开发工具。 - 管理员按员工查询用量;员工离职后,停用对应账号及 Key。
ai.example.com 是示例域名。实际操作时,请替换为企业自己的域名。
先分清两套账号和 Key
| 项目 | RootFlowAI | 企业自建 sub2api |
|---|---|---|
| 谁登录 | 企业采购或平台管理员 | 企业管理员和员工 |
| 账户用途 | 统一采购、维护上游权限、核对实际消耗 | 管理员工、内部预算、个人 Key 和用量 |
| API Key 用途 | 供 sub2api 连接 RootFlowAI | 供员工的工具连接企业网关 |
| 管理入口 | RootFlowAI 账户中心 | 企业自己的平台域名 |
| 员工拿到什么 | 通常不直接领取上游 Key | 本人的登录账号和个人 API Key |
企业在 RootFlowAI 只需维护一个账户。根据协议、权限和预算隔离需要,可以在这个账户下创建少量专用上游 Key,例如分别用于 Claude 和 GPT;不必按员工数量创建上游 Key。
sub2api 的“账号管理”主要管理上游供应商连接,“用户管理”管理员工登录账户。本教程会分别称为“上游账号”和“员工账号”。
采购额度与员工预算有什么区别
RootFlowAI 余额用于实际采购结算;sub2api 员工余额用于企业内部的用量分配和访问控制。

图 D02-A:在 RootFlowAI 账户中心查看采购账户余额和实际消费,作为上游结算依据。查看清晰原图。

图 D02-B:在企业 sub2api 查看内部请求与用量统计。右上角余额属于企业平台内的登录账户,员工预算在“用户管理”中单独设置。查看清晰原图。
两张截图的统计范围和时间窗口不同,不用于金额直接对比。sub2api 截图版本为 v0.2.19,本文配置参考 v0.2.21,菜单以实际部署版本为准。
分配内部预算不会给上游充值。
在 sub2api 给员工增加余额,不会增加 RootFlowAI 账户余额。sub2api 页面中的 $ 表示其内部计价单位,不能直接理解为人民币,也不代表与 RootFlowAI 实际扣费金额自动一致。
模型价格、分组倍率、缓存单价和统计时区会影响两边记录。企业可以先用内部预算控制使用范围,再按实际采购价格校准成本分摊。详见添加员工与设置预算。
按角色选择阅读路线
| 你现在要做什么 | 从这里开始 |
|---|---|
| 第一次部署企业平台 | 部署你的企业网关 |
| 已经部署,需要连接 RootFlowAI | 接入 RootFlowAI |
| 给同事开通账号、分配预算 | 添加员工与设置预算 |
| 我是员工,只需要配置工具 | 员工快速开始 |
| 员工离职、备份或升级 | 日常管理与维护 |
| 调用失败、没有模型、额度异常 | 常见问题排查 |
管理员建议按“部署 → 接入 → 添加员工”的顺序完成配置,然后将员工快速开始页面发给同事。员工无需阅读服务器部署章节。
推荐的内部使用方式
- 使用 Linux 服务器和 Docker Compose 部署,配置企业域名及 HTTPS。
- 使用
standard模式,让员工余额参与校验。 - 由管理员创建员工账号,关闭不需要的公开注册入口。
- 为每位员工建立独立普通用户,由员工自行管理个人 Key。
- 先接通一个模型平台,再通过复合分组扩展到多个平台。
- 管理员维护用户余额、授权和并发限制,员工的 Key 限额用于进一步约束个人工具。
员工一个 Key 同时使用多个模型平台,需要配置复合分组;普通分组通常对应具体平台。具体步骤见接入 RootFlowAI。
上线前完成这些检查
- 企业域名通过 HTTPS 访问,管理员可以正常登录。
- 上游 Key 权限、模型配置、分组授权一致,至少完成一个实际请求。
- 两名员工能分别登录,只能查看自己的 Key 和个人明细。
- 员工无法自行增加用户余额或获取未授权分组。
- 停用一名员工后,另一名员工仍可使用。
- 已保存可恢复的备份,并明确日常维护人员。
企业管理员负责自建服务器、sub2api 配置、员工权限和数据备份;RootFlowAI 提供上游 API 服务及本站账户的使用支持。自建网关的可用模型,取决于上游 Key 权限、sub2api 支持的协议以及企业配置。
下一步:部署你的企业网关。已部署的管理员可直接查看接入 RootFlowAI。